
The problem with mosl real-lime operating systems is 
simple, they're not an integrated solution. Vtou end up dealing 
with a multitude of suppliers for languages, compilers, debug- 
gers and other important development tools. And when 
something does ro wrong, it con be a frustrating experience 
trying to straighten out the mess. 

Why Not Try the 
Microware One-Stop 
Total Solution? 

Microware's OS-9 Real-Time 
Operating System is a total inte- 
grated software system, not just 
a kernel. \Afe offer an extensive 
set of development tools, lan- 
guages, I/O and Kernel options. 
And this total integrated solution 
is entirely designed, built and 
supported by the same expert 
Microware team. 
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The OS-9 Success Kit 



A Total Integrated Solution for Your Next Project 

Langu ages: 



Development Tool*; 

C Source Level DeDu<K)e' 
Symbolic DBbuggur 
System Stale Debugger 
u MACS foil Editor 
Bert rpmc Mall 
Communications 
Super Shell 

Kernel Options: 

MMU (Security protection) Support 
Mltfl Coprocessor Support 
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Modularity Lets YOU Choose lust What You Need. 

The modular design of OS-9 allows our Operating System 
to adapt as your requirements change. OS-9 can support a 
complete spectrum of applications — from embedded ROM- 
based code in board-level products all the way up to large 
scale systems. 

Support is Part 
of the Package. 

Microware is proudly setting 
the industry's standard for cus- 
tomer support. Ytju'll find pro- 
fessional and comprehensive 
technical documentation and a 
Customer Hotline staffed by 
courteous and authoritative soft- 
ware engineers. 

So slop messing with sim- 
ple kernels and independent 
suppliers. Call Microware today 
and find out more about the 
"One-Stop Integrated Solution" 
with OS-9! 
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Baste 

Pascal 

Fortran 

Ada" 

Assembler' 

I/O Options: 

SCSI. SASI&SMD Disks 
3-. 5-. 8-inch Diskettes 
Magnetic Taee 
Ethernet . TCP/ II" 
Arcnel- OS-9 /Net 
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Microware Systems Corporation 
1900 N.W. II 4th Street 
Des Moines, Iowa 50322 
Phone: 515/224- 1929 



Western Regional Office 
4401 Great America Parkway 
Santa Clara, California 95054 
Phone: 408/980-0201 



Microware japan Ltd. 
41-191 loncho 4 -Chome 

FunabashiCity 
Chiba 273, Japan 
Phone: 0474 (22) 1747 



GMX MICRO-20 and TWINGLE-20 PRICE LIST 




All versions include 1 SAB Board 




MICRO-20 with 1MB RAM 


MICRO-20 with 2MB RAM 


TWINGLE-20 with 4MB RAM 


12.5 MHz 


1855.00 


2155.00 


3855.00 


16.67 MHZ 


2185.00 


2485.00 


4185.00 


20 MHZ 


2585.00 


2885.00 


4785.00 



I/O EXPANSION BOARDS 



OPTIONAL PARTS AND ACCESSORIES 



68881 12 5MHz Floating Point Coprocessor $ 165.00 

68881 16 67MHz Floating Point Coprocessor $ 225.00 

68881 20MHz Floating Point Coprocessor $ 345,00 

MOTOROLA 68020 USERS MANUAL $ 18.00 

MOTOROLA 68030 USERS MANUAL S 18.00 

MOTOROLA 68881 USERS MANUAL $ 18.00 

MilHiWWHilinBTOirEiWg $1399.00 

Tin package includes a PC-style cabinet wtth a custom backpanel, 
a 25 Megabyte (unformatted) hard disk and controller, a floppy disk 
drive, a ISO wall power supply, cooling fan, panel mounted reset and 
aoci switches, and all necessary internal cabling. (For use with 
SAB— 90 serial connectors only.) 

2nd5*80 FLOPPY & CABLES FOR M20-AP. ADO $ 250.00 

SECOND 25MB HARD DISK & CABLES. ADO S 780,00 

TO SUBSTITUTE 50MB HO FOR 25MB HO. ADD $ 290.00 

TO SUBSTITUTE 80M8 HD FOR 25MB HO. ADO $1500.00 

TO SUBSTITUTE 155MB FOR 25M8 HD, ADD $21 00.00 

60M8TEAC STREAMER WITH ONE TAPE S 690.00 

PKG.0F5TEACTAPES $ 112.50 

CUSTOM BACK PANEL PLATE (8PP-PC) S 44.00 

»TIJiT:T«?ITaWTlTJ:liliTTn'IRT=T>gI.i.i1 J 335.00 

The SBC-16S extends the I/O capabilities of the GMX Mlcro-20 
68020 Single-board Computer by adding sixteen asynchronous 
serial I/O ports. By using two SBC-16S boards, a total of thirty-six 
serial ports are possible. 

laJWMiiifjaunwjiq^pfja yumMiaii.'.i. $165.00 

The board provides level-shifting between TTL level and 
standard RS-232 signal levels for up to 4 serial I/O ports. 

i.iiniMatf:i:rjm«Hii:iifj:iiin:iw.iiiui $398.00 

The GMX SBC-60P uses three 68230 Parallel interlace/Timers 
(Pl/Ts) 10 provide up to toity-eight parallel I/O lines. The I/O lines 
are buffered in six groups ot eight lines each, with separate butler 
direction control tor each group. Butler direction can be fixed by 
hardware jumpers, or can be software programmable tor 
bidirectional applications. 

■ J ilillif J-ijllj l d:|ir.lHif HiliB'.'ifll $75.00 

The SBC- WW provides a means o' developing a <id testing 
custom I/O interlace designs tor the GMX Micro-20 68020 Single- 
board Computer. The board provtdes areas for both DIP (Dual Inline 
Package) and PGA (Pin Grid Array) devices, and a pre-wired 
memory area for up to 512K bytes of dynamic RAM 

■Hil:HWJiMa»:ll.l:HB*H S195.0O 

The SBC-BA provides an I nlerlace between the GMX Mlcro-20 
6802a Single-board Computer and the Motorola Input/Output 
Channel (I/O bus). With the t/0 bus. up to sixteen off-the-shelt or 
custom peripheral devices (I/O modules) can be connected to the 
GMX Mlcro-20. 

H-ffllgffllfflfraiBWff.lMMI.'l $475.00 

The SBC-AN provides an interlace between the GMX Mlcro-20 
68020 Single-board Computer and the ARCNET modified token- 
passing Local Area Network (IAN) originally developed by Oatapoint 
Corp. The ARCNET is a baseband network with a data transmission 
rate ot 2.5 Megabits/second. The standard transmission media is a 
single 93 ohm RG-62/U coaxial cable. Fiber optic versions are 
available as an option. 

0S9 LAN Software Olivers tor SBC-AN 120.00 



GfTlX 1337 W. 37th Place. Chicago, 1L 60609 



GMX MICRO-20 SOFTWARE 



020 BUG UPDATE - PROMS ft MANUAL $150.00 

THESE 60020 OPERATING SYSTEMS ARE PRICED 
WHEN PURCHASED WITH THE MICRO-20. PLEASE 
ADD t1 50.00 IF PURCHASED LATER FOR THE 
UPDATED PROMS AND MANUALS. ALL SHIPPED 
STANDARD ON 5% " DISKS 3Vi" OPTIONAL IF 

SPECIFIED. 

■ 

0S9/68020 PROFESSIONAL PAK $850.00 

Includes O.S.. "C". uMACS EDITOR. ASSEMBLER, DEBUGGER, 
development utilities, 68881 support. 

OS9/68020 PERSONAL PAK $ 400.00 

Personal QS-9 systems require a GMX Micro-20 development 
system running Prolessional OS-9/68020 tor initial configuration ._ 

BASIC (included in PERSONAL PAK) ... ....% 200.00 

C COMPILER (included In PROFESSIONAL PAK) $ 750.00 

PASCAL COMPILER $ 500.00 

UniFLEX (tor Micro-20) $ 400.00 

UniFLEX WITH REAL-TIME ENHANCEMENTS $ 800.00 

UniFLEX VM (torTWINGLE-20) $ 600.00 

UniFLEX VM REAL-TIME ENHANCEMENTS $1000.00 

UniFLEX BASIC W/PRECOMPILER ... ,...$ 300.00 

UniFLEX C COMPILER $ 350.00 

UniFLEX COBOL COMPILER $ 750.00 

UniFLEX SCREEN EDITOR $ 150.00 

UniFLEX TEXT PROCESSOR $ 200.00 

UniFLEX SORT/ MERGE PACKAGE $ 200.00 

UniFLEX VSAMMOOULE $ 100.00 

UniFLEX UTILITIES PACKAGE I S 200.00 

UniFLEX PARTIAL SOURCE LICENSE $1000.00 

GMX EXCLUSIVE VERSIONS, CUSTOMIZED FOR 
THE MICRO-20, OF THE BELOW LANGUAGES 
AND SOFTWARE ARE ALSO AVAILABLE 
FROM GMX. 

ABSOFT FORTRAN (UniFLEX) $1500.00 

SCULPTOR (specify UniFLEX or 0S9) S 995.00 

FORTH (0S9) $ 595.00 

OYNACALC (specify UniFLEX or 0S9) $ 300.00 

GMX DOES NOT GUARANTEE PERFORMANCE OF ANY GMX 

SYSTEMS, BOARDS OR SOFTWARE WHEN USED WITH 

OTHER MANUFACTURERS PRODUCT. 

ALL PRICES ARE F.O.B. CHICAGO IN U.S. FUNDS 

GMX, Inc. reseives the right to change pricing, terms, and 

products specifications at any time without lurther notice. 

TO OROER BY MAIL: SEND CHECK OR MONEY ORDER OR USE 

YOUR VISA OR MASTER CHARGE. Please allow 3 weeks tor 

personal checks to clear US orders add $5 handling If under 

$200.00. Foreign orders add $10 handling It order is under 

$200.00. Foreign orders over $200.00 will be shipped via Emeiy Air 

Freight COLLECT, and we will charge no handling. All orders must 

be prepaid in U.S. funds. Please note that foreign checks have 

been taking about 8 weeks tor collection so we would advise wiring 

money, or checks drawn on a bank account in the U.S. Our bank is 

the Continental Illinois National Bank ot Chicago, 231 S. LaSalle 

Street. Chicago. IL 60693, account number 73-32033. 

CONTACT GMX FOR MORE INFORMATION ON THE ABOVE 

PRODUCTS 

GMX STILL SELLS GIMIX S50 BUS SYSTEMS. BOARDS & PARTS. 

CONTACT GMX FOR COMPLETE PRICE LIST. 

(312) 927-5510 — TWX 910-221-4055 — FAX (312) 927-7352 
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68 MICRO JOURNAL 

Computer Publishing Center 

5900 Cassandra Smith Road 

PO Box 849 

Hixson,TN 37343 

Phone (615) 842-4600 Telex 510 600-6630 

Copyrighted © 1987 by Computer Publishing. Inc. 

68 Micio Journal is the origina/" DeskTop Publishing" product and has 
continously published since 1978 using only micro-computers and 
special "DeskTop" software. Using first a kit built 6800 micro-com- 

f niter, a modified "ball" typewriter, and "home grown" DeskTop Pub- 
ishing software. None was commercially available at that lime. F*r 
over 10 years we have been doing "DeskTop Publishing"! We origi- 
nated what has become traditional "DeskTop Publishing"! Today 68 
Micro Journal isacknowledgedasthe"Grandfather"of"DeskTop Pub- 
lishing" technology. 



68 Micro Journal is publ ished 1 2 times a year by Computer Publishing 
Inc. Second Class Postage paid ISSN 0194-5025 at Hixson. TN. and 
additional entries. Postmaster: send form 3597 to 68 Micro Journal. 
POB 849. Hiwon. TN 37343. 

Subscription Rates 

1 Year $24.50 USA, Canada & Mexico $34.00 a year. 

Others add $12.00 a year surface, $48.00 a year Airmail, USA 

funds. 2 years $42.50, 3 years $6430 plus additional postage 

for each additional year. 

Items or Articles for Publication 

Articles submitted for publication must include authors name, ad- 
dress, telephone number, date and a statement that the material is 
original and the property of the author. Articles submitted should be 
on diskette, OS-9, SK*DOS. FLEX, Macintosh or MS-DOS. All 
printed items should be dark type and satisfactory for photo-reproduc- 
tion. No blue inkl No hand written articles • please ! Diagrams o.k. 

Please -do not format wdhspaces any lejt indents, charts. etc. (source 
listing ok). We will edit in all for mailing Text should fatlflushleft and 
use a carriage return only to indicate a paragraph end. Please write 
for free authors guide. 

Litters & Advertising Copy 

L tetters to the Edilorshould be the original copy, signed! Letters ofgiip 
is well as praise are accept* Me. We reserve i he right to reject any teller 
or advertising material, for any reason we deem advisable. Advertis- 
ing Rates: Commercial please contact 68 Micro Journal Advertising 
Department. Classified advertising must be non-commercial. Mini- 
mum of $15.50 for first 15 words. Add $.60 per word thereafter. No 
classifieds accepted by telephone. 
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With 'C Source | (g^ 

$229.00 [ W^^sm 
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PAT FROM S. E. MEDIA - A FULL FEATURED SCREEN ORIENTED TEXT EDITOR 

with all the best of PIE. For those who swore by and loved PIE, this is for YOU! All PIE 
features & much more! Too many features to list. And if you don't like ours, change or add 
your own. C source included. Easily configured to your CRT terminal, with special configuration 
section. No sweat! 

68008 - 68000 - 68010 - 68020 OS-9 68K $229.00 



COMBO 






PAT i JUST 

Special $249.00 

JUST 

JUST from S. E. MEDIA - - Text formatter written by Ron Anderson; for dot matrix 
printers, provides many unique features. Output formatted to the display. User con- 
figurable for adapting to other printers. Comes set-up for Epson MX80 with Graflex. Up 
to 10 imbedded printer control commands. Compensates fordouble width printing. 
Includes normal line width, page numbering, margin, indent, paragraph, space, vertical 
skip lines, page length, centering, fill, justification, etc. Use with PAT or any other text 
editor. The ONLY stand alone text processor for the 68XXX OS-9 68K, that we have 
seen. And at a very LOW PRICE! Order from: S.E. MEDIA - see catalog this issue. 

68008 - 68000 - 68010 - 68020 OS-9 68K 
V With 'C source $79.95 J 
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The MUSTANG-020 68020 SBC provides i powerful. 
compact. 32 bit computer system featuring the "state of the art" 
Motorola 68020 "super" micro-procosoi. It comes standard 
with 2 megabyte of high-speed SIP dynamic RAM. serial and 
parallel ports, floppy di*k: contro Her. a SASI hard disk interface 
for intelligent hard disk controllers and a battery backed -up 
time-of-day clock. Provisions are made for the super powerful 
Motorola MC6888 1 floating point math co-processor, for 
heavy math and number crunching applications. An optional 
network interface uses one serial (four (4) standard, expandable 
to 20) as a 125/bit per second network channel. Supports as 
many as 32 nodes. 

The MUSTANG-020 is ideally suited to a wide variety of 
applications. It provides a cost effective alternative to the other 
MC68020 systemsno w available. ! lis an excellent introductory 
tool to the world of hi-power, hi-speed new generation "super 
micros". In practical applications ithas numerous applications, 
ranging from scientific to education. It is already being used by 
government agencies, labs, universities, business and practi- 
cally every other critical applications center, worldwide, where 
true multi-user, multi-tasking needs exist. Tlie MUSTANG- 
020 is UNIX C level V compatible. Where low cost and power 
is a must, the MUSTANG-020 is the answer, as many have 
discovered. Proving that price is not the standard for quality! 

As a software development station, a general purpose 
scientific or small to medium business computer, or a super 
efficient real-time controller in process control the MUS- 
TANG-020 is the cost effective choice. With the optional 
MC68881 floating point math eo-otocesscr installed, it has ihe 
capability of systems costing many times over it's total acqui- 
sition cost 

With the DATA COMP "total package", consisting of a 

Data-Comp Division 

n /<^^fc\ A Decade of Quality Service'^ 

Tj n|3§P? Systems World-Wide 

Computer Publishing, Inc. 5900 Cssaflra Smith Road 
TBfc^ore 615 842-4601 -Telex 51 060W630 rfeson.Tn 37343 



DATA-COMP Proudly Presents the First 

Under $4300 "SUPER MICRO" See other 

advertising (backcover) for economy 

system (68008) - under $2400 complete! 



heavy duty metal cabinet switching power supply with rf/line 
by-passing, 5 inch DS/DD 80 track floppy. Xebec hard disk 
controller. 25 megabyte Winchester hard disk, four serial RS- 
232 ports and a UNIX C level V compatible multi-tasking, 
multi-user operating system, the price is under $4300. w/12.5 
megahertz system clock (limited time offer). Most all popular 
high level languages are available at very reasonable cost. The 
system is expandable to 32serial ports, at a cost ofl ess than S6S 
per port, in multiples of 8 port expansion options. 



The SBC ftilly populated, quality tested, with 4 serial ports 
prewired and board mounted is available for less that $2500. 
Quantity discounts are available for OEM and special applica- 
tions, in quantity. All that is required to bring to complete 
"system" standards is a cabinet, power supply, disks and oper- 
ating system. All these are available as separate items from 
DATA-COMP. 




AtailabU 12 J- 25 Wu tysUms. call for special frits 

A special version of the Motorola 020-BUG is installed on 
each board. 020-BUG is a ROM based debugger package with 
facilities for downloading and executing user programs from a 
host system. It includes commands for display and modifica- 
tion of memory .breakpoint capabilities, a powerful assemble!/ 
disassemble and numerous system diagnostics. Various 020- 
BUG system routines . such as I/O handlers are available for user 
pro grams. 

Normal system speed is 3 4 3 MIPS, with burst up to 10 
MIPS, at 16.6 megahertz. Intelligent I/O available for some 
operating systems. 

Hands-on "actual experience sessions", before you buy, 
are available from DATA-COMP. Call or write for additional 
information or pricing. 
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Mustang Specifications 

1Z5 MHz (option,! 16.6 Mhx a vtilable) MC68020 full 32-bit wide path 

32-bit wide data and addreu btaMe, oon-mulupicxed 

on chip irjsructirai cache 

object codtcnrTpatirjIetrilr] ,11 68XXX flmi ly praffion. 

enhanced inaVudion let - maih co-pncEBcc interface 
68881 maihhi-eprol fleeting tnmoa-rnraBaot (optional) 

dilOCt aatrrnainn of full 68020 UBTQW3USI mot 
full support IEEE P754. draft 10.0 
uvruxndfnal atir) other aoeraific math funcTbaru 
2 Megabyte of SIP RAM (512 x 32 bit orgaraxatiori) 
up lo 256K byte* of EPROM (64 a 32 bin) 

4 Aayncrwonorat aerial I/O potts standard 
optional to 20 tent] potts 
standard RS .232 interface 
oOTiana] network interface 

Toed 8 bil parallel poll (1/2 MC68230) 
Cenrranua type pinout 
ejrauisiuD ctsanrrtirt far 1/0 device* 
1 6 all data path 
236 byte addrnu (pace 
2 interrupt input* 
dock and cerorol signal* 
MrJtoroU I/O Ounnel Module* 
time of day riodL/calendar w/baoery baduip 
Exa^lmU er for 2, S 1 r4* Oopr/y diak dnvec 
aingle at double aide, tingle or double density 
35 to 80 trmck aeuxtab le (4« .96 TPI) 
SASI interface 

ftugiajitf rnblc periodic interrtxpt genentor 
iniemipt rate from mLcro-szTonda to teoand* 
higMy acctnie time baac (S PPM) 

5 bit *cn*e awitch, readable by the CPU 
Hardware nngle- step capability 

Theras hi-«p™d 68020 <y*teroa are prearntly vtaxing n NASA, Atomic Energy Ctajnrniision , 
Gover nm ent Agertcie* as orcll as Umrcnriesaa, Businema, Laba. and ether Critical AppUcariorot 
Coaun, woddwulo, where apoeA rnatb ounchirtg and multvuser. mufd- taalung UNTX C levd 
V cornpatabtblyand low coat ia amuai 




Don't be mislead! 

ONLY Dala-Comp 

delivers the Super 

MUSTANG-020 



bnly the "PRO" Version 
of OS-9 Supported! 




This is HEAVY DUTY 

Country! 
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Price List: 






Mutur.g-020SBC 




S2490.00 


Cahina w/awitcrung PS 




KW.95 


S"-80 track floppy DS/DD 




S269.95 


Floppy Cable 




539.95 


OS-9 68K Profcauan al Vortion 




$850.00 


C Compiler (J500 Value) 




NAC 


Wutchealer Cable 




J39.95 


Winchester Drive 25 Mbyte 




$895.00 


Hard Disk Control let 




1395 00 


Slapping USA UPS 




S20.00 


UniFLEX 


Leu 


S 100.00 


MC6888) iff math pnnwor 


Add 


J275.00 


16.67 Mhr MC68020 




$375.00 


16.67 Mhz MC6888! 




$375.00 


20 Mhz MC68020 Sy> 




$750.00 


Note *U 68881 chip* work with 20 Mhz Sy* 






Total: 


S529S.80 
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D ata-C omp Division 

s*i /i .^aaaaaaaa*^'?*^ A Df«atde of Quality Service* m __ 
Compular PubilaMng. Inc. 5900 C«»»an*« Smitti Road 



Tataphor* 61 5 842-4601 . Tu*ui 510 600-6630 



Hmoo. Tn 37343 



Save $1000.00 
Complete 

25 Mbyte HD System 
$4299.80 

85Mbyte HD System 
$5748.80 

Note: Only Proiession-1 OS-9 Now Available (68020 Version) 

Includes (S500) C Compiler - 68020 & 68881 Stipported - 

For UPGRADES Write or Call for Piofessioiul OS-9 Upgrade Kit 



68 Moro Journal 



JuJy'88 




The C Programmers 

Reference Source. 
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A Tutorial Series 



By: Dr. E. M. Bud' Pass 
1454 Latia Lane N.W. 
Conyers. GA 30207 
404 483-1717/4570 

Computer Systems Consultants 



This chapter begins the discussion of dbug, a 
C debugging package. It Is a useful tool for debug- 
ging and testing C programs. It was developed by 
Fred Fish, who placed it Into the public domain. 
Much of the coverage following Is based on the 
documentation provided by Fred, who Is also 
responsible for the floating-point library dis- 
cussed In previous chapters. The C code for the 
dbug package and for extensions to it appear in 
subsequent chapters. 

FRED FISH'S DBUG PACKAGE 

All of the features of the dbug package can be 
enabled or disabled dynamically at execution 
tune. They may also be disabled statically at 
compilation time. This means that production 
programs will run normally when debugging is 
not enabled, and multiple versions of a program 
for production and for testing need not be main- 
tained. 

Many of the debugging actions easily accom- 
plished with conventional debugging tools, such 
as symbolic debuggers, are dlflkult or Impossible 
to accomplish with this package, and vice versa. 
Thus, the dbug package should not be thought of 
as a replacement or substitute for other debug- 
ging tools, but as a useful addition to the familiar 
set of tools. If they are available on a given sys- 
tem. 

Almost every non-trivial pro-am development 
and debugging environment provides some sort of 
debugging facility. Usually this takes the form of a 
program which ts capable of controlling execution 
of other programs and examining the Internal 
state of other executing programs. 

Such programs are examples of external 
debuggers since the debugger is not part of the 
executing program. Examples of this class of 
debugger program Include theadb and sdb 
debuggers provided with UNIX, and, at a much 
lower level, the debug debuggers provided with 
MSDOS. FLEX. UNIFLEX. and OS-9. 



One of the problems associated with develop- 
ing programs In an environment with good exter- 
nal debuggers is that developed programs tend to 
have little or no Internal Instrumentation. 

This is usually not a problem for the developer 
since they are. or at least should be. Intimately 
familiar with the Internal organization, data 
structures, and control flow of the program being 
debugged. 

II is a serious problem for maintenance 
programmers, who are unlikely to have such 
familiarity with the program being maintained, 
modified, or ported to another environment. 

It Is also a problem, even for the developer, 
when the program Is moved to an environment 
with a primitive or unfamiliar debugger, or even 
no debugger. 

The dbug package Is an example of an inter- 
nal debugger, because It requires Internal Instru- 
mentation of a program. Its usage does not 
depend on any special capabilities of the execu- 
tion environment. It is always available and will 
execute in any environment in which that the 
program Itself will execute. Since dbug Is a com- 
plete package with a specific user Interface, all 
programs which use it will be provided with 
similar debugging capabilities. 

The dbug package Imposes only a slight speed 
overhead on executing programs, typically much 
less than 10 percent, and a modest size overhead, 
typically 10 to 20 percent. By defining a C pre- 
processor symbol (DBUG_OFF). both of these can 
be reduced to zero, wtth no modifications required 
to the source code. 
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DBUG CAPABILITIES 

Following Is a summary of the capabilities of 
the dbug package. Each capability may be en- 
abled or disabled at the time a program Is Invoked 
by specifying the appropriate command line 
arguments. 

Execution trace showing function-level control- 
flow In a (p~aphlcal manner using Indentation to 
Indicate nesting depth. 

Output the values of all. or any subset of. Internal 
variables. 

Limit actions to a specific set of named functions. 

Limit function trace to a specified nesting depth. 

Label each output line with souice file name and 
line number. 

Label each output line with name of cuirent 
process. 

Push or pop Internal debugging state to allow 
execution with built-in debugging defaults. 

Redirect the debug output stream to standard 
output (stdout) or a named file. The default 
output stream Is standard error (stderr). 



PRIMITIVE DEBUGGING TECHNIQUES 

Internal Instrumentation Is already a familiar 
concept to most C programmers, since it Is usu- 
ally the first debugging technique learned. Typi- 
cally, print and/or assertion statements are 
Inserted Into the source code at strategic loca- 
tions, the code is recompiled and executed, and 
the resulting output Is examined In an attempt to 
determine where the problem is. 

The procedure is iterative, with each Iteration 
yielding more and more output, and hopefully the 
source of the problem is discovered before the 
output becomes too large to deal with or previ- 
ously Inserted statements need to be removed. 
Following Is a trivial example of this type of 
primitive debugging technique. 



•include <»tdlo.h> 

main (arqc, arqv) 
int arqc; 
char *arqv(]; 
( 



int I; 

tor {I - 0; i < arqc; ♦ ♦!) 

prlntf <"arqv(l) - ls\n", arqvliS); 



print f ("arqc - Id\n*, arqc); 



prlntf (■»«« done — \n") ; 



Usually after several iterations, the problem 
will be isolated and corrected. 

At this point, the newly-inserted debugging 
print statements must be eliminated or disabled 
to prevent them from corrupting the normal 
program output. 

One obvious solution is to simply delete the 
debugging statements. Beginners usually do this 
a few times until they have to repeat the entire 
process every time a new bug is discovered or 
extensive modifications must be performed on the 
program. 

Another obvious solution Is to somehow 
disable the output, either through the preproces- 
sor /* - */ comment facility, the preprocessor 
#lfdef - #endlf exclusion facility, or the creation of 
a debug variable to be switched on or off as 
needed. 

Following is an example of the use of all three 
techniques. 



•include <stdio.h> 



int debug; 

main (arqc, 
int arqc; 
char *arqv[); 
( 

int 1; 



argv) 



for 



»/ 



(i « 0; 1 < argc; 
printf Carqvll] < 



+♦1) 
ls\n" 



arqvtll); 



if (debug) 



printf ("arqc » ld\n", arqc); 



lifdef oeauG 

printf ("-- done — \n"> ; 
tend it 
) 
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Each technique has Its advantages and 
disadvantages with respect to dynamic versus 
static optlnal usage, source code overhead. 
recompUatlon requirements, ease of use. program 
ieadablllty, etc. Overuse of the preprocessor 
solution quickly leads to major problems with 
source code readability and maintainability when 
a multitude of preprocessor symbols must be 
tfdefme'ed or flundef ed based on specific types of 
debugging output required. 

FUNCTION TRACE EXAMPLE 

The capabilities of Fred Fish's dbug package 
are demonstrated thru the use of a simple pro- 
gram which computes the factorial of a number. 
In order to better demonstrate the function trace 
mechanism, this program is Implemented recur- 
sively. 

Following Is the main function for this facto- 
rial program. 

•Include <stdlo.h> 
•include "dbug.h" 

main large, argv) 
int argc; 
char *argwl); 



( 



lx++) 



register inc. ix; 
register int result; 
extern int atoi (>; 
extern int factorial () ; 

DBUG_eKTER ('main") ; 

DBOG_PROCESS <argv[Q)); 

for (ix - 1; ix < argc it argv[ixl[0) "■ '-• ; 



I 

switch (argv(ix) (1]) 

( 

case "f : 

DBUG_PUSH (t{argv(ix][2]>>; 
break; 

) 

I 

for < ; ix < argc; ix**) 

< 



argvlixJH; 



) 



DBUG_PRnra ("args", CargvUd] - *s", lx, 

result • factorial (atol (argv(ixl)); 
printf (Md\n", result) ; 



DBUG RETURN <0); 



The main function Is responsible for process- 
ing any command line option arguments and then 
computing and printing the factorial of each non- 
option argument. 

The debugging functions are Implemented via 
preprocessor commands. 



This does not detract from the readability of 
the code and makes disabling all debug compila- 
tion trivial, as the existence of preprocessor 
symbol DBUG_OFF causes the dbug commands 
to be nullified. 

The header file dbug.h must be Included from 
the local header file directory whenever the dbug 
package Is to be used. This file contains all the 
definitions for the debugging commands, which 
have the form DBUG_XX...XX. 

Following are the dbug commands used In 
this example program: 



The DBUG_ENTER command Indicates that a 
function has been entered. It must be the first 
executable line in a function, after all declarations 
and before any other executable lines. 

The DBUG_PROCESS command Is used only 
once per program to Indicate the name under 
which the program was Invoked. 

The DBUG_PUSH command modifies the 
cuirent debugging state by saving the previous 
state and setting a new state based on the control 
string passed as Its argument. 

The DBUG_PR1NT command prints the values 
of each of Its argument. 

The DBUG_RETURN command Indicates that 
the end of the function has been encountered and 
returns a value to the calling function. 



One advantage of using the dbug package Is 
that it encourages structured coding with only 
one entry and one exit point In each function. 
Multiple exit points, such as early returns to 
escape a loop, may be used, but each such point 
requires the use of an appropriate 
DBUG_RETURN or DBUGJVOID.RETURN com- 
mand. 

To Invoke the debugger, the factorial program 
Is invoked with a command line of the following 
form: 



factorial -#d:t 1 2 3 



The main function recognizes the "-#d:t" 
string as a debugging control string, and passes 
the debugging arguments Cd:t"! to the dbug 
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runtime support routines via the DBUG_PUSH 
command. This particular string enables output 
from the DBUG_PRINT command with the 'd" flag 
and enables function tracing with the 't' flag. The 
factorial function is then called three times, with 
the arguments "1". "2". and "3". Note that 
DBUG_PR1NT requires exactly two arguments, 
with the second argument (a format string and 
list of printable values) enclosed in parentheses. 

Debug control strings consist of a header, the 
"-#". followed by a colon separated list of debug- 
ging arguments. Each debugging argument is a 
single character flag followed by an optional 
comma separated list of arguments specific to the 
given flag. 

Some examples are as follows: 



-#d:t:o -#d.ln.out:f.maln:F:L 



Note that previously-enabled debugging 
actions can be disabled by the control string *-#". 

The definition of the factorial function. "N!". Is 
given by the following formula: 



N! = N • (N - 1) • ... 2 * 1 



Following ts the factorial function which 
Implements this algorithm recursively. Note that 
this is not necessarily the best way to calculate 
factorials and that any error conditions are 
ignored. 



•include <stdio.h> 
•include "dbug .fl- 
irt factorial (value) 
register int value; 



value) ) ; 



DBU5_ENTER ("factorial"); 

DBU5_PRINT ("find", ("find Id factorial' 

if (value > 1) 

value "• factorial (value - 1); 
DBUG PRINT ("result", ("result is Id". 



value) ) ; 



DBUG RETURN (value) ; 



To build the factorial program on a UNIX 
system, compile and link with the following 
command: 



cc -o factorial maln.c factorlal.c dbug.c 

Executing the factorial program with a com- 
mand of the following form: 

factorial 12 3 4 5 

generates the output shown In the following 
list; 

1 

2 

6 

24 

120 

Function level tracing ts enabled by passing 
the debugger the T flag in the debug control 
string. 

Following is the output resulting from the 
following command: 

factorial -#t:o 3 2 



1 


>f actorial 




1 


1 >factorial 




1 


1 <factorial 




1 


<f actorial 




2 


>f actorial 

] >factorial 






t 1 >factoria 


1 




t I <factoria 


1 




1 <factorial 






<f actorial 




6 






<main 





Each entry to or return from a function is 
Indicated by V for the entry point and "<' for the 
exit point, connected by vertical bars to allow 
matching points to be easily found when sepa- 
rated. 

This trace output Indicates that there was an 
Initial call to factorial from main (to compute 2!). 
followed by a single recursive call to factorial to 
compute 1!. The main program then output the 
result for 2! and called the factorial function 
again with the second argument. 3. Factorial 
called itself recursively to compute 2! and 1!. then 
returned control to main, which output the value 
for 3! and exited. 

Note that there is no matching entry point 
"maln>" for the return point "<main" because at 
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the time the DBUG_ENTER command was 
reached In main, tracing was not enabled yet. It 
was only after the command DBUG_PUSH was 
executing that tracing became enabled. This 
Implies that the argument list should be proc- 
essed as early as possible since all code preceding 
the first call to DBUG.PUSH is essentially invis- 
ible to dbug. This can be circumvented by Insert- 
ing DBUG_PUSH(argvll]) immediately after the 
DBUG_ENTER("maln") command. 

The trace output is normally produced on the 
standard eiror file. 

Since the factorial program prints Its result on 
the standard output, there is the possibility of the 
output of the program being scrambled if the two 
streams are not synchronized. 

Thus the debugger Is told to write Its output 
on the standard output instead, via the 'o* flag 
character. No 'o' Implies the default (standard 
error), a 'o' with no arguments means standard 
output, and a *o" with an argument means use the 
named file. 

For example, the following command: 

factorial -#t:o.logflle 3 2 

would place the trace output In "logflle". 
Because of Implementation details, programs 
usually run faster when wilting to stdout rather 
than to stderr on many operating systems, 
though this Is not a prime consideration In this 
example. 

DBUG.FRINT COMMAND 

The mechanism used to produce printed 
output is the DBUG_PRINT command. 

To allow selection of output from specific 
command, the first argument to every 
DBUG_PRINT command is a dbug keyword. When 
this keyword appears in the argument list of the 
'd' flag in a debug control string, as in "- 
#d,keywordl ,keyword2....:t", output from the 
corresponding command is enabled. The default 
when there is no *d" flag in the control string Is to 
enable output from all DBUG_PRINT command. 

Typically, a program will be run once, with no 
keywords specified, to determine what keywords 
are significant for the current problem (the key- 
words are printed In the command output line). 
Then the program will be run again, with the 



desired keywords, to examine only specific areas 
of interest. 

The second argument to a DBUG_PRINT 
command is a standard prlntf style format string 
and one or more arguments to print, all enclosed 
In parentheses, so that they collectively become a 
single command argument. This is how variable 
numbers of prlntf arguments are supported. Also 
note that no explicit newllne Is required at the 
end of the format string. As a matter of style, two 
or three small DBUG_PRINT command are prefer- 
able to a single command with a huge format 
siring. 

Below is the output for default tracing and 
debugging, using the following command line: 

factorial -#d:t:o 3 



args: argv[2] - 3 
factorial 

find: find 3 factorial 
>factorial 

find: find 2 factorial 
>factorial 

I find: find 1 factorial 
I result : result i3 1 
<factorial 
result: result is 2 
<factorial 
result : result is 6 
factorial 



6 

<main 



The output from the DBUG_PRINT command 
Is Indented to match the trace output for the 
function in which the command occurs. When 
debugging is enabled, but not trace, the output 
starts at the left margin, without indentation. 

To demonstrate selection of specific command 
for output, below Is the result when the factorial 
program is Invoked with the following debug 
control string: 



-#d.result:o 

factorial: result: result is 1 
factorial: result: result is 2 
factorial: result: result is 6 
factorial: result: result Is 24 
24 



10 
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It Is sometimes desirable to restrict debugging 
and trace actions to a specific function or list of 
functions. This may be accomplished with the 'f 
flag character In the debug control string. The "F' 
flag enables printing of the source file name and 
the "L" flag enables prtntlng of the source file line 
number. 

Below is the output of the factorial program 
when run with the following control string: 

-#d:f,factorial:F:L:o 

factorial. c: 8: factorial: find: find 3 factorial 

factorial. c: 8: factorial: find: And 2 factorial 

factorial. c: 8: factorial: find: llnd 1 factorial 

factorial. c: 11: factorial: result: result Is 1 

factorial. c: 11: factorial: result: result Is 2 

factorial. c: 11: factorial: result: result Is 6 



The output shows that the "find" command Is 
in file "factorial.c" at source Hue 8 and the "result" 
command Is In the same file at source line 1 1. 

SUMMARY OF DBUG COMMANDS 
AND CAPABILITIES 

The following summarizes the usage of all 
commands defined In the dbug package. The 
command definitions are found In the user in- 
clude file dbug.h from the standard Include 
directory. 



DBUG_ENTER(char •) 

The DBUG_ENTER command is used to tell 
the runtime suppoit module the name of the 
function being entered. It must precede all other 
executable lines In the function Just entered, and 
must be placed after all local declarations. Each 
DBUG_ENTER command must have a matching 
DBUG.RETURN or DBUG_VOID_RETURN com- 
mand at the function exit point. DBUG_ENTER 
command used without a matching 
DBUG_RETURN or DBUG_VOID_RETURN com- 
mand will cause warning messages from the dbug 
package runtime support module. 

DBUG.RETURN (value) and 
DBUG_VOID_RETU RN 

The DBUG_RETURN and 
DBUG_VOID_RETURN commands are used at 
each exit point of a function containing a 
DBUG_ENTER command at the entiy point. The 
argument of the DBUG_RETURN command is the 
value to return. Functions which return no value 



(void) should use the DBUG_VOID_RETURN 
command. It is an error to have a DBUG_RETURN 
or DBUG_VOID_RETURN command In a function 
which has no matching DBUG_ENTER command. 

DBUG_PROCESS(char *) 

The DBUG_PROCESS command is used to 
name the program being executed. A typical 
argument for this command Is "argvlOl". 

DBUG_PUSH(char •) 

The DBUP_PUSH command sets a new debug- 
ging state by pushing the current debugging state 
onto an Internal stack and setting up the new 
state using the debug control string passed as the 
command argument. The most common usage is 
to set the state specified by a debug control string 
retrieved from the argument list. Note that the 
leading "-#" in a debug control siring specified as 
a command line argument must not be passed as 
pait of the command argument. The proper usage 
is to pass a pointer to the first character after the 
*-#• string. 

DBUG_POP() 

The DBUG_POP command restores the previ- 
ous debugging state by popping the state stack. 
Attempting to pop more states than pushed will 
be Ignored and no warning will be given. 

FILE •DBUG_FILE 

The DBUG_FILE command is used to do 
explicit I/O on the debug output stream. It is 
used in the same manner as the symbols "stdout" 
and "stderr" in the standard I/O package. 

DBUG_EXECUTE(char •. fcnO) 

The DBUG_EXECUTE command Is used to 
execute any arbitrary C code. The first argument 
is the debug keyword, used to trigger execution of 
the code specified as the second aigument. This 
command must be used cautiously because, like 
the DBUG_PRINT command. It is automatically 
selected by default whenever the 'd* flag has no 
argument list (I.e., a *-*d.t" control string). 

DBUG_PRINTtchar *.(char ♦)) 

The DBUG^PRINT command is used to do 
printing via the fprintf library function on the 
current debug stream. DBUG_FILE. The first 
argument is a debug keyword, the second is a 
format string and the corresponding aigument 
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list. Note that the format string and argument list 
are all one command argument and must be 
enclosed In parentheses. 

DBUG_SETJMP(env) 

The DBUG_SETJMP command Is used in 
place of the setJmpO function to first save the 
cuirent debugging state and then execute the 
standard setjmp call. This allows the debugger to 
restore Its state when the DBUGJ.ONGJMP 
command Is used to invoke the standard 
longjmpO call. Currently all Instances of 
DBUG_SETJMP must occur within the same 
function and at the same function nesting level. 

DBUGJX)NGJMP(env. value) 

The DBUG_LONGJMP command is used In 
place of the longjmpO function to first restore the 
previous debugging state at the time of the last 
DBUG_SETJMP and then execute the standard 
longjmpO call. Currently all DBUG_LONGJMP 
commands restore the state at the time of the last 
DBUG_SETJMP. It would be possible to maintain 
separate DBUG_SETJMP and DBUGJXDNGJMP 
pairs by having the debuggtng runtime support 
module use the first argument to differentiate the 
pairs. 

DEBUG CONTROL STRING 

The debug control string Is used to set the 
state of the debugging via the DBUG_PUSH 
command. This section summarizes the currently 
available debugging options and the flag charac- 
ters which enable or disable them. Argument lists 
enclosed In '[' and ']" are optional. 



dl. keywords) 

Enable output from command with specified 
keywords. A null list of keywords Implies that all 
keywords are selected. 

Dl.tlmel 

Delay for specified time after each output line, 
to let output drain, lime is given in tenths of a 
second (value of 10 Is one second). Default is zero. 

fl .functions] 

Limit debugging actions to the specified list of 
functions. A null list of functions Implies that all 
functions are selected. 



Mark each debugging output line with the 
name of the source file containing the command 
causing the output. 



g 



Turn on machine independent profiling. A 
profiling data collection file, named dbugmon.out. 
will be written for postprocessing by the "analyze" 
program. 



Mark each debugging output line with the 
source file line number of the command causing 
the output. 



Mark each debugging output line with the 
current function nesting depth. 



N 



Sequentially number each debugging output 
line starting at 1. This is useful for reference 
purposes when debugging output is Interspersed 
with program output. 

ol.llle] 

Redirect the debugging output stream to the 
specified file. The default output stream is stderr. 
A null argument list causes output to be redi- 
rected to stdout. 

pl.processesl 

Limit debugging actions to the specified 
processes. A null list implies all processes. This Is 
useful for processes which run child processes on 
multi-tasking systems. Note that each debugging 
output line can be marked with the name of the 
current process via the 'P* flag. The process name 
must match the argument passed to the 
DBUG PROCESS command. 



Mark each debugging output line with the 
name of the current process on multi-tasking 
systems. This Is most useful with a process 
which runs child processes that are also being 
debugged. Note that the parent process must 
arrange for the debugging control string to be 
passed to the child processes. 



\2 
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PROBLEM AREAS 



Used In conjunction with the DBUG_PUSH 
command to reset the current Indentation level 
back to zero. Most useful with DBUG_PUSH 
commands used to temporarily alter the debug- 
ging state. 

t|.N| 

Enable function control flow tracing. The 
maximum nesting depth Is specified by N. and 
defaults to 200. 



The dbug package works best with programs 
which have "line-oriented" output, such as text 
processors, general purpose utilities, etc. 

It can be interfaced with screen -oriented 
programs, such as visual editors, by redefining 
the appropriate dbug commands to call special 
functions for displaying the debugging results. 

Of course, this problem is not encountered if 
the debugging output Is simply dumped Into a file 
for post-execution examination. 



HINTS AND TIPS 

One of the most useful capabilities of the 
dbug package Is to compare the executions of a 
gtven program in two different environments. This 
Is typically done by executing the program In the 
environment where it behaves properly and 
saving the debugging output In a reference Die. 
The program Is then run with identical Inputs In 
the environment where it misbehaves and the 
output Is again captured in a reference file. The 
two reference files can then be differentially 
compared to determine exactly where execution of 
the two processes diverges. 

A related usage Is regression testing where the 
execution of a current version is compared 
against executions of previous versions. This Is 
most useful when there are only minor changes. 



Programs which use memoiy allocation 
functions other than malloc will often have prob- 
lems using the standard dbug package without 
modification. Itie most common problem is 
multiply-allocated memory. 

DBUG PACKAGE CODE 

The actual C code for the dbug package starts 
in the next chapter. 



EOF 



FOR THOSE WH 
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LOOSE ENDS 

This monih I decided to spend lime wrapping up some 
loose ends. Loose ends are those little pieces hanging out of a 
package after you've finished wrapping it In this case the 
package is this column and the loose ends are items of informa- 
tion that I find left undone and incorrectly leported. (Gasp! I do 
sometimes make mistakes.) This month I propose to attack 
some past material that I believe has some loose ends. 

POINTERS 

1 find that I play loose and frae with pointers in C language 
from time to lime. In many cases the result is an obvious and 
blatanieiror. These I catch immediately and don't pass on. But 
occasionally I gel away wiih creating a pointer error and no one 
yet has called me on it. ( Although one reader, has mentioned 
this problem, but not necessarily attributing it to me.) 

Let me review pointers in C Language. A pointer is a 
variable thai points to a variable. Now that is a fairly simple 
idea. I don't know of too many olher programming languages 
thai use pointers. Pascal does have a type of variable called 
pointers, but I am not really sure that it is same as iheC language 
type. BASIC09 allows referencing vaiiables by their names. In 
C. the actual location of Ihe variable can be used . Perhaps a few 
examples are in order. Heie are a few. 

cliar name|30); 

int 'number; 

inta.b; 

char* 'lines; 



Hie first case, char name(30], is siring of 30 bytes. If we 
just use 'name', we are using its pointer. If we reference it by 
index, say 'name(S]' . we indicate one byte in ii. The second cas, 
int 'number, is two bytes long. But it is a pointer to an integer 
variable. Ii is not the integer. The third case, int a.b, contains 
a declaration of two integers, two bytes each. The lasi one, char 
"lines, is a pointer to a list of pointers called 'lines'. Again it 
is only two bytes long. 

Knowing how and when to when to use these is the trick. 
Most limes you will want to use a variable and not a pointer to 
it. Pointers are used when passing a variables location. The can 
also be used for programming tricks. Bui whatever the reason, 
it musi be done correctly. 

Now let me show you how easy it is to misuse a pointer. 
The following is how to get the lime. This how ii is wiitien in 
the C Manual. 

(♦include <time.h> 
getime( buffer ) 
struct sgibuf 'buffer 

Prelly straight foiward, huh? No problems. Declare a 
buffer as illustrated, pass ii to getime and it returns the lime. 
Wiih luck it just mighi! But this is not how to use ihis defini- 
tion. 

Ihe definition says thai a pointer musi be passed, but it is 
not not correct to declare a pointer. Why? Because no where 
has the variable been created for ihe elements of lime — year, 
month, day, hour, minute, and second. Creating a pointer docs 
not provide ihe variable. Here is a little illustration to prove what 
I have said. 



14 



July 88 



68 Mao Journal 



0001 / 
0002 

0003 • 

0004 «U 

0005 ( 
0006 
0007 
00OB 
0009 

0010 I 



* Example Co ehow how pointers and 
variable* differ V 

Include <tlme.h> 

• ln{) 

struct agtbuf 'time]; 

struct agtbuf tlme2; 

prlntf rTlnel la *d In slze.Vn", slieofl timel )): 

prlntf ("Time? Is %d In sl2e.\n*, slieofl time? )); 



I have used two different ways for cieaiing a structure. 
Now let's try this program . 

'Timel ' is 2 bytes in size and 'iime2' is 6 bytes. The 
memory requirements for ihe time buffer must be 6 bylcs, so 
this would indicate lhai 'Ume2' should work. But what about 
'timel '? It is only a pointer. 'Timel ' will be set to a value of 
$0000. When it is passed to geiime(), the 6 bytes will be placed 
at position $0000. 

What occurs at position $0000 can have an effect on what 
is returned. It happens that on the Coco I have had no problems 
when this error occurs. On my Smoke Signal Level n, I come 
back with erroneous results. One reader leported that on his 
Atari ST system, he experienced clashes. The moral is to use 
the variable concctly. 

This month I have included in listing 1 a program from 
some time back. This is a leplacement for your standard DATE 
command. Thisonediffersina few ways. Itcan print the lime 
in military or standard notation. Also it will print lime and date 
in a gieeting fashion. 

In this version ( Listing 1 ). I have changed how the 
structure for the time buffer is declared. This version is correct 
and creates a real buffer. The early version made the error of 
creating only a pointer. Take a look at it and sec how the buffer 
is created. 

When passing the buffer pointer, a & is added to the front 
of the variable name. The line 

gctime( Alime ); 

says to pass the pointer of 'lime' to 'getime'. This is the 
exactly how it should be done, but this time it is done with a real 
variable declared. 

One other change is that I put into this version of DATE a 
greeting for some holidays. Forexample, on July 4th.it will say 

Happy 4th of July! 

I have omitted some holiday. You can add any that you 
like. Also, you may want to add birthdays, anniversaiies and 
whatever else you like. 

SIGNALS, ONE MORE TIME 



Last month 's topic was signals. I talked about how signals 
were sent and icceived. I also presented a little program called 
DAEMON. It would take over control of the terminal keeping 
whoever envoked it. from doing anything else. Entering 
CONTROL-C or CONTROL-E would not stop it This is 
where the signal handling came in. 1 lie program had a bap to 
catch incoming signals. It would mock any attempts to halt it. 
It had only one problem when wiiting it. 

The original version I created had printfO and getsO in it 
These two routines are pait of Ihe higher order C Library 
functions, lite first version I wrote had a number of problems. 
Basically, text handled by the higher library functions became 
messed up and the progiam ran amok. I took the cowards way 
out, I lewrotc the program using rcadlnfj ad writeln(). This 
solved the problem but did not explain why. 

I found an interesting paper written by Kim Kempf called 
"C Tricksand Treats". The paper was distributed by Microware 
Sysiemsaioneof the annual OS-9 conferences. Inepapergave 
some insight into the problem. ( It also inspired the first pan of 
this month's column.) I won' ttellaJl that it contained, but lei me 
give you the run down on what it says regarding the signal 
handler. 

It tells that C Library I/O should not be done in signal 
handlers. The functions use sialic storage and therefore notie- 
enterant. Using such functions can result in unpredictable 
results. 

IdidabiiefexaminationoftheClibiary.clib.l. I found that 
printfO was part of a module called prinif_c which had 33 local 
references. Gels() was pan of ge(s_c which has no local 
variables. These two modules reference other external symbols 
that were located in other modules. The lesults was that there 
were static variables used when using these functions. 

On the other hand, writeln() and readln() weie part of a 
module called io_a. Preferences no external variables. There- 
fore no static variables were involved. 

I have not gone back and rewritten the program, 
DAEMON.C. I leave this up to some industrious soul out there. 
I think that writing it with printfO and getsO would serve no 
purpose, except to be an exeicisc. The progiam would not be 
anymore transponable since I he signal handler is rather specific 
to the OS-9 system. 

Well that concludes another month. I think I have tied up 
of few loose ends. (And maybe created a few new ones.) Until 
next time have fun! 

LISTING 



0000 
0001 
0002 
0003 
0004 



/• 



Name: Date.c 
Date: 30-MAR-87 
Author: Ron Volgts 
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0005 


Compiler: Mlcroware C Compiler 






0072 


if 1 gflag | ( 


0006 
0007 








0073 
0074 


if ( time.t_hour< 12 ) 

printf ("Good Morning ! \n") ; 




0008 








0075 


else if 1 time.t_hour<18 ) 


0009 


version 1.00 Original RDV 






0076 


printf ["Good Afternoon !\n") ; 


0010 








0077 


else 


0011 


Version 2.00 






0078 


printf ("Good Evening ! \n") ; 


0012 


Fixed time storage buffer and 






0079 


) 


0013 


added holiday greeting. RDV 






0080 




0014 
0015 
0016 








0081 /• 

0082 

0083 


Print the date */ 
if ( gflag ) 

print f ("Today is ") ; 








0017 


Function: 






0084 


pdatel (time ) ; 


0018 


Prints the date. 






0085 /• 


Print the day of the week V 


0019 


-t - with the time 






0086 


if ( dflag ) ( 


0020 


-m - time in military notation 






0087 


if ( gflag > 


0021 


-d ■ with the day of the week 






0088 


prlntf("It is ").- 


0022 


-g - with a greeting 






0089 


pday ( ILlme ) ; 


0023 


-h • holiday greeting 






0090 


I 


0024 








0091 




0025 
0026 








0092 f 
0093 


Print the time */ 
if < tflag ) ( 








0027 


Idefine LEVEL2 






0094 


if < gflag ) 


0028 








0095 


printf {"The time is ") ; 


0029 


•include <stdio.h> 






0096 


if ( mflag ) 


0030 


•include <tlme.h> 






0097 


pmttjiie( ttime ) ; 


0031 


•include "getopt.c" 






0098 


else 


0032 








0099 


ptimel (time, pmflag ); 


0033 


Idefine TRUE 1 






0100 


1 


0034 


Idefine FA1.SE 






0101 




0035 








0102 /< 


Print holiday greeting •/ 


0036 


main) argc, argv ) 






0103 


if ( hflag ) ( 


0037 


lnt argc; 






0104 


if ( time.t_day--l it time.t_month--l ) 


0038 


char *argv[]; 






0105 


printf ("Happy New *ear!\n">; 


0039 


( 




1 


0106 


if ( time .t_day™14 (t time.t month—2 | 


0040 








0107 


printf ("Happy Valentine's Day!\n'); 


0041 


stiuct sgtbuf time; 






0108 


if ( time.t day»»17 (( time.t month—3 ) 


0042 








0109 


printf ("Happy St. Patrick's Day!\n"); 


0043 


/* Parameter flags */ 






0110 


if ( time.t_day-'20 (t time.t month--3 ) 


0044 


int mflag - FA1.SE; /* Military tlnre 


*/ 




0111 


printf ("Ft' s the First Day of 


0045 


int tflag - FALSE; /• Print time •/ 






Spring 


\n"l ,- 


0046 


int dflag - FAI.SE; /• Print the day 


*/ 




0112 


if ( time.t_day~21 it time.t_month--4 > 


0047 


int gflag ■ FAI.SE; /• Greeting flag 


*/ 




0113 


printf ("It's Aimed Forces Day.\n' ); 


0048 


int pmflag - TRUE; /* PM flag V 






0114 


if ( time.t_day~14 Li time.t_ronth--6 ) 


0049 


int hflag • FAI.SE; /• Holiday greet 


rig 


*/ 


0115 


printf ("It's Flag Oay.\n"); 


0050 








0116 


if ( time.t_day»»21 (( time .t_month~6 ) 


0051 


/• Variables used •/ 






0117 


printf ("It's the First Day of 


0052 


char 'option; 






Summer. 


\n-) ; 


0053 


char •optlist-'MDTGH"; 






0118 


if ( time.t_day~4 tt time.t_month-»7 ) 


0054 








0119 


printf ("Happy 4th of Joly!\n"); 


0055 


/* Process the input line */ 






0120 


if I time.t day--22 (( time.t month--9 ) 


0056 


optn-1; 






0121 


printf ("It's the First Day of 


0057 


while ( [opt ion-get opt I argc, argv. 


opt list )] 


Autumn. 


\n-) ; 


!- NULL > 






0122 


if 1 tlme.t_day--31 (( tlme.t_month="=10 ) 


0058 


if ( opterr !- ) 






0123 


printf ("Trick or Treat, it's 


0059 


dhelpO; 






Halloween :\n") ; 


0060 


else { 






0124 


if ( t ime . t_day—2 1 (( time .t_month--12 ) 


0061 


if I toupper (option (0] ) •» 


'H' 


) mflag • 


0125 


printf ("It's the First Day of 


TRUE; 








Winter. 


\n-) ; 


0062 


if { toupper (option 10]) -- 


•D' 


) dflag • 


0126 


if ( time.t day«-25 4( time.t nonth--12 | 


TRUE; 








0127 


printf ("Merry Christmas ! \n") ; 


0063 


if t toupper (option (0]> -- 


»?' 


) tflag ■ 


0128 


) 


TRUE; 








0129 ) 




0064 


if ( toupper (option (01) — 


<G' 


) gflag ■ 


0130 




TRUE; 








0131 




0065 


if ( toupper (option (0]) — 


fP 


) hflag ■ 


0132 /• 


Help for date •/ 


TRUE; 








0133 dhelpO 


0066 


1 






0134 ! 




0067 








0135 


printf ("Usage: \n") ; 


0068 


/* How get the time */ 






0136 


printf <" date |-t] |-m) I-d] |-g) |-h]\n"); 


0069 


getimel (time ); 






0137 


printf t" -t " wlth the tlme\n"); 


0070 








0138 


prlntff" -m ■ time in military 


0071 


/* Print the greeting */ 






notatic 


n\n") ; 
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0139 printf<* -d - with the day of the 


0196 


"February", 


weekVn") ; 


0197 


"March", 


0140 printf(" -g ■ with a greetingVn") ; 


0198 


•April", 


0141 printf(" -h - with holiday greetingVn"); 


0199 


"May", 


0142 exit! ) ; 


0200 


"June", 


0143 • 


0201 


"July", 


0144 


0202 


"fcigust". 


0145 


0203 


"September", 


0146 /• Print the day of the week •/ 


0204 


"October", 


0147 pdayt t > 


0205 


"November", 


0148 struct sgtbuf *t; 


0206 


"December" 


0149 [ 


0207 


>; 


0150 


0208 




0151 /• Variables used */ 


0209 


printfCIs %2d, 19%02d\n", 


0152 int n; 


month! («t> .tmonth). 


0153 register int i; 


0210 


{•t).t_day, (»t).t_year ) ; 


0154 int fudge-3; /• My fudge factor •/ 


0211 




0155 


0212 


) 


0156 static char *day[] - [ 


0213 




0157 "Sunday", 


0214 


/• Print the time •/ 


0158 'Monday", 


0215 


ptimel t, pf ) 


0159 "Tuesday", 


0216 


struct sgtbuf «t; 


0160 "Wednesday", 


0217 


int pf; 


0161 "Thursday", 


0218 


( 


0162 "Friday", 


0219 


• 


0163 "Saturday" 


0220 


If ( Ct) .t_hour<12 ) 


0164 I; 


0221 


pf. FALSE; 


0165 


0222 


if I ft) .t_hour>12 ) 


0166 static int day_count [ | ■ { 


0223 


(•t) .t hour-»12; 


0167 31, 28, 31, 30, 


0224 


prlntf ("%2d:%02d:»02d ", |'t).t_hour. 


0168 31, 30, 31, 31, 


022S 


(•tl.t minute, (*t) .t second ); 


0169 30, 31, 30, 31 


0226 


if ( pf ) 


0170 ); 


0227 


print f <"PMVn"»; 


0171 


0228 


else 


0172 /• Calculate today's day of the week •/ 


0229 


prlntf ("fcMVn"); 


0173 n « («t).t_year + fudge + t (*t) .tjyear»3)/ 


0230 


I 


4; 


0231 




0174 for < i=0; i<{"t> .t_month ,- it+ ) 


0232 


/• Print in military time •/ 


017S n+-day count 111; 


0233 


pnit lnie < t ) 


0176 n+-<*t) .t day; 


0234 


struct sgtbuf *t; 


0177 


0235 


< 


0178 /• Adjust if this is leap year •/ 


0236 


printf ("%02d:%02d:%02dVn", («t> .thour. 


0179 if I (Ct).t_year % 4 1—0 «« 


0237 


(•t).t minute, («t> .t_second > ; 


(•t) .t month>2 ) 


0238 


I 


0180 n++; 


0239 




0181 






0182 /• Print day of the week •/ 






0183 printf|"»s ", day[ n % 7 )); 






0184 






01BS } 






0186 


+♦+ 




0187 /• Print the date */ 






0188 pdate ( t ) 






0189 struct sgtbuf *t; 






0190 ( 






0191 






0192 /• The 12 months •/ 






0193 static char 'month [) - < 






0194 "Unknown", 






0195 "Jaunary", 








FOR THOSE WHi 


a 
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OS9 - SK*DOS Text File Interchange 



I have been running 
both SK'DOS and OS9 
on the 68008 machine 
for some lime, and for 
various reasons I 
wanted to be able to 
move text files back 
and forth between the 
two systems. SK'DOS 
being considerably 
simpler than OS9. I 
decided I would work at 
the project from the 
SK'DOS end and leave 
the OS9 end alone. 
Therefore it was neces- 
sary to work with an 
OS9 foimatted disk. 
The first problem is an 
incompatibility with the 
way side select works 
between OS9 and 
SK'DOS. It was imme- 
diately necessary to 
limit the disk to single 
sided, though 80 tracks 
and double density 
work nicely. I decided 
to go for double density 
In order to allow the 
most text on a disk. 
Since the programs are 
based on a number of 
assumptions including 
the number of sectors 
per track, the double 
density becomes a 
necessity for a disk to 
work with these pro- 
grams. 



I got out my Sherlock 
Holmes hat and sat 
down to see what I 
could ftnd out. 
(Holmes would have 
called this a "ten pipe" 
problem but since I 
don't smoke It became 
a two liter Cheny Coke 
and bag of pretzels 
problem). The easy 
half of the project Is to 
write a file with OS9 
and figure out how to 
read it into an SK'DOS 
file. I decided to tackle 
thatlirst. The most, 
valuable tool I have for 
this project is the 
SDUMP program that I 
wrote first. SDUMP is 
a take-off on the 
MDUMP and DDUMP 
programs published 
here last time. 
SDUMP. however works 
strictly with reading 
sectors from the disk. 
The user specifies the 
track and sector and it 
is read and displayed. 
With this utility. I was 
able to examine the 
first sectors on track 
zero of the OS9 disk 
and find the directory 
sectors. I found that 
there are 8 entries per 
sector, except the first 
which has six. A good 



start at the project 
would be a directory 
utility that would read 
the filenames and 
starting sectors for 
each file from the OS9 
disk. What follows are 
the somewhat incoher- 
ent notes that I took in 
the process of getting 
the Job done: 

OS9 Disk Format 

This Is an attempt to 
analyze the disk format 
of an OS9 foimatted 
disk to see if It is 
feasible to copy ASCII 
files from OS9 to 
SK'DOS. Because of 
differences tn side 
selection, the OS9 disk 
is foimatted single 
sided. In order to limit 
the problem a little, I 
chose double density 
and 80 tracks though 
40 would work fine. I 
found that in order to 
format a disk single 
sided I just had to 
answer "N" to the 
prompt In OS9 FOR- 
MAT that asks if it is 
OK to proceed. OS9 
then prompts for single 
or double density, 
single or double sided, 
number of tracks, and 



ask if format should be 
changed to 48 TPI (in 
simple teims that 
means "do you want 
double stepping?). 

Once the disk was 
foimatted I copied 
some files to it. (Still in 
OS9 ofcouise). For 
testing purposes I 
copied my source 
CJUST.C. SIDIO.H. 
and CTYPE.H files to / 
DO root directory. 

Dumping track 00 
sector 03 showed a 
directory. See dump of 
0003. The first $40 
bytes (00 to 3F) con- 
tained some informa- 
tion that I didn't need 
to interpret. The 
directory starts at byte 
$40 and every 32 bytes 
thereafter. If enough 
files are written. It will 
continue in the next 
sector. 00 04 etc. 

A little investigation 
revealed that bytes 30 
and 31 ($1E and IF) of 
the directory entiy are 
the 16 bit sector num- 
ber of the flist sector of 
the file. The sector 
number is not quite the 
same as the track and 
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sector number. OS9 
formats track zero with 
10 sectors. 0000 
through 0009. The 
remaining tracks have 
1 6 sectors each . Un- 
fortunately sector 
count OA refers to track 
01 sector 00 which is 
the next sector after 
track/sector 0009. If 
we add 6 to the sector 
count, the last hex digit 
is the sector number 
and what precedes it is 
the track. For example, 
the directory on t/s 
0003 shows that 
CJUST.C file starts at 
sector 000B. Add 6 
and we get 001 1. The 
00 1 means track 1 
and the last digit 1 
means sector 1 . 

I dumped track/ 
sector 0101 we get the 
information sector for 
that file. (See dump for 
0101). I don't know 
what the folks at 
Microware call this 
sector for a sequential 
Me. but I'll refer to it as 
the File Information 
Record or FIR for short. 

Byte 00 of the FIR 
is the attribute byte 
$3F in the present case 
meaning directory. 
That Is. if an attribute 
is on. the bit position in 
that byte is a 1 . if not. 
it Is a zero. Byte 01 
and 02 are zeros in all 
the records that I have 
looked at. Possibly 
they have to do with 
sub directories. Bytes 
03 - 05 are the year, 
month, and day in that 
order. $57 translates 
to decimal 87. $0C is 
12 and $01 Is 1 so the 
date is 87/ 12/1 or 
December 1 1987. The 
next two bytes (06 and 



07) are the hour and 
minute again In Hex. 
$0A is 10 and $08 is of 
course 8 so the time is 
10:08. This Is 24 hour 
time. I found by exam- 
ining the information 
sector for another file 
where the hour is $ 1 1 
and the minute Is $2A, 
which translate to 
17:42 or 5:42 PM. 

Bytes 08 and 09 
code something we 
don't need, perhaps the 
owner's code. Bytes 
$0A and $0B contain 
$0035 which Is 53 
decimal. There are 53 
complete sectors in the 
text that follows. The 
54th is the last and 
partial sector. Byte 
$0C contains the count 
of characters in the last 
sector! the $0F indi- 
cates 15 characters. A 
check of the last sector 
of this file 0500 shows 
that bytes 00 to OE 
inclusive are data. 
That Is a count of $0F 
or 15. 

The last three bytes 
of the lirst group of 16 
seem to be a repeat of 
the date information we 
found In bytes $03 to 
$06. Perhaps one is the 
creation date and the 
other the date of the 
most recent update. 
That doesn't matter 
much to the object of 
this exercise. Bytes 
$12 and $13 contain 
the sector number 
($OC) of the lirst data 
sector. In this case, we 
add 6 and get $0012 so 
we know that if we 
dump track 01 sector 
02 we will see the first 
sector full of data. The 
last item in the infor- 
mation sector is the 



total number of sectors 
Including the last 
partial one. Bytes $13 
and $14 contain that 
count. (I am assuming 
that files over 255 
sectors long have the 
count overflow into the 
next higher byte $13.) 
In the present case the 
HEX 36 translates to 
decimal 54 sectors. 
That agrees with the 
earlier 53 sector plus 
$0F byte count. Actu- 
ally that is really 
$00350F bytes In the 
first line, since in this 
case the sectors con- 
tain 256 bytes, the 
interpretation is arbi- 
trary. 

After figuring that 
out. I knew how to read 
a filename in the 
directory and find out 
what track and sector 
contalnwd the informa- 
tion record. I knew 
how to read the infor- 
mation record to find 
out the sector count 
and number of bytes to 
read in the last sector, 
so I was all set to dump 
a sector and see what 
was there. It turned out 
that the SK'DOS 
SREAD function did 
Just fine. All I had to 
do Is point A4 at an 
FCB. put the drive 
number in byte 3 of It. 
the track in byte 34 
and the sector in byte 
35. Now I called 
SREAD and the result 
was what Is shown in 
the dumped data 
sector. Note first of all 
that unlike FLEX or 
SK*DOS. there are no 
sector linkage bytes in 
the sector. There are 
256 bytes of data. At 
lirst glance that looks 
very efficient, but 



remember that a whole 
sector was used for the 
FIR. I strongly suspect 
that as files get frac- 
tured due to repeated 
file deletions and 
additions, a whole lot 
more of that sector Is 
used up as a sector 
map. I'll stick to 
freshly formatted disks 
and files copied with no 
deletions for this 
exercise, however. I'll 
also not bother investi- 
gating the complexities 
of random files. 

About then I fig- 
ured it was about time 
to start writing an 
SK'DOS utility to do a 
directory and add the 
$06 to the sector count 
to display the starting 
track and sector for 
each Hie. Then I figured 
I could write a simple 
copy utility that could 
read the information 
sector and read the 
OS9 file, writing it to an 
SK'DOS file. Assuming 
that all directories for 
this disk configuration 
start at t/s 0003 and 
are sequential. I'd read 
the directory until the 
first byte of what 
should be the next 
entry Is a null. Proba- 
bly, when the directory 
overflows. OS9 allo- 
cates some sectors 
elsewhere and puts 
them In a sector map 
that we could follow, 
but I decided that since 
the purpose of the disk 
in question Is to trans- 
fer some files from OS9 
to SK'DOS. I would be 
careful not to overflow 
the normal directory 
sectors and thus 
simplify the problem. 
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There Is room for 6 
dlrectoiy entiles on 
sector 0003 and for 8 
entries each on sectors 
4 through 9 for a total 
of 54 files before the 
sequential directory 
sectors on track get 
full. That should be 
more than adequate for 
transferring files from 
OS9 to SK*DOS. 

Listing l shows the 
directory utility which 
reports the filename 
and the starting sector 
(the FIR) for each file In 
the directory. The 
utility is called 
OS9DIR. The next step 
was to write an 
OS9COPY utility that Is 
given the track and 
sector (as presented in 
the OS9DIR utility) and 
a filename to which to 
write the text on the 
SK'DOS disk. 

OS9COPY Is the 
result of an evening's 
programming and 
debug. Using the 
procedure outlined 
above. It copies files 
from an OS9 formatted 
disk and writes them to 
a standard SK*DOS 
file. OS9 normally does 
not use space compres- 
sion. That Is. If the text 
file contains 20 spaces 
there are 20 space 
characters In the file. 
However. I did find one 
file with horizontal tab 
characters $09 In it. 
and It did not copy 
correctly to the 
SK'DOSdlsk. The file 
was part of A *C" 
compiler (the STDIO.H 
file). Perhaps the 
compiler uses com- 
pressed files. Any file 
that I had edited under 
OS9 copied over with 



no problems. Perhaps 
someday III combine 
OS9DIR and OS9COPY 
and add a siring match 
routine so It can copy a 
named file from an OS9 
disk to a named file on 
an SK'DOS disk. 
Meanwhile, the two 
utilities together are 
very handy. 

Sector dumps 
follow: 

Track 00 Sector 03 
(first directory 
sector) 



1 started out the hard 
way to ilnd the last 
used sector. I found 
the last directory entry, 
went to the FIR for that 
file, added the sectors 
used to the starting 
sector to arrive at the 
next unused sector. I 
noted that last direc- 
tory entry position and 
figured I would write 
the filename and 
starting sector there 
alter I had written the 
file. 



00 2EAE OOOOOOOOOOOOOOOOOOOO 
10 000000000000000000000000 
20 AEOOOOOOOOOOOOOOOOOOOOOO 
30 00 00 00 00 00 00 00 00 00 00 00 00 
40 63 6A 75 73 74 2E E3 00 00 00 00 00 
so 00 00 00 00 00 00 00 00 00 00 00 00 
60 73 74 64 69 6F 2E E8 00 00 00 00 00 
70 000000000000000000000000 
80 63 74 79 70 65 2E E8 00 00 00 00 00 
90 00 00 00 00 0000 00 0000000000 
AD 00 000000 00000000 00000000 
BO 000000000000000000 000000 
CO 0000 000000 00000000000000 
DO 000000000000000000 000000 
EO 000000000000000000000000 
FO 000000000000000000000000 



00 00 00 00 
00 00 00 02 
00 00 00 00 
00 00 00 02 
00 00 00 00 cjustc 
00 00 00 OB 
00 00 00 00 stdlo.h 
00 00 00 42 
00 00 00 00 ctypc.h 
00 00 00 4B 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 
00 00 00 00 



IrackOl Sector 01 serial sector OB FIR of cjustc 

00 3F00 00 57 0C01 OAOBOI 00 00 35 OF 57 OC 01 

10 00000C00360000000000000000000000 

Remainder of sector Is all 00 

Track 1 Sector 02 first data sector of cjust.c 

00 2F 2A 20 4A 55 S3 54 20 74 65 78 74 20 66 6F 72 
/•JUST text for 

10 6D 6 1 74 74 65 72 20 66 6F 72 30 43 65 6E 74 72 
■natter for Ccntr 



etc. Data runs to last 
byte of sector and 
multiple spaces are not 
compressed in any way. 

Having finished the 
above utilities. I de- 
cided to try the more 
ambitious project of 
writing a utility to copy 
files from SK*DOS to 
OS9 on the OS9 for- 
matted disk. That was 
a little more challenge. 



Later, when I had 
written a file to the OS9 
disk with SK*DOS 
(successfully). I found 
that OS9 didn't even 
see the directory entry. 
A little sector dumping 
found that track 00 
sector 02 has a pointer 
to the next empty 
directory entry posi- 
tion. When the disk 
was first formatted a 
dump of that sector 



showed bytes OB and 
OC of the sector to 
contain $0040. Byte 
40 of the first directory 
sector (03) Is the 
location for the first 
directory entry. When I 
copied a file to the disk 
from OS9 those byles 
changed to $0000 and 
the directory entry 
appeared at location 
$40 In sector 3 of track 
0. I booted up OS9 and 
wrote a number of files 
to the disk, each time 
watching that value 
increment by $20. It 
reached OOEO and the 
next file that I wrote 
made It Increase to 
0100. It was clear that 
the value In byte $0B. 
when 3 Is added to It. Is 
the sector number and 
the next byte Is the 
pointer to the address 
In the sector for the 
next directory entry. 1 
decided that I could 
rewrite a little to pick 
up the first empty 
directory location by 
reading these bytes, 
though 1 delayed that 
for finishing the Initial 
version. I fixed my 
SK'DOS write program 
to bump this pointer by 
$20 and sure enough. 
OS9 then listed the 
directory entry, but It 
couldn't open the file. 

I looked more 
closely and found that 
the OS9 written direc- 
tory entries had the 
high order bit of the 
last character set. 
Some software I've seen 
uses this technique to 
signal the end of a 
string without wasting 
an extra character as a 
terminator. I llxed my 
program to do that and 
wrote another file to the 
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disk while running 
SK'DOS. OS9 would 
now recognize the file 
and could open and 
read It. 

Now I discovered 
another feature of OS9. 
When I wrote another 
file to the disk from 
OS9 it overwrote the 
Hie I had Just written to 
it in SK'DOS. A dump 
of track 00 sector 01 
showed a pattern of 
bits that changed when 
I wrote a file to the disk 
from OS9. I puzzled 
over it for some time 
until I realized that 
there are 1 60 bytes in 
the map and that each 
byte is 8 bits. It be- 
came apparent that the 
bits in this sector 
correlate 1 to 1 with 
which sectors are In 
use and which are free. 
A 1 In a bit indicates 
the corresponding 
sector is not available 
for user files. The first 
two bytes in the map 
for a freshly formatted 
disk are $FFEO. Each 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
11 
15 
16 
17 
IB 
19 
20 
21 
22 
23 
24 
25 
26 
27 
28 
29 
30 
31 000000 A000 



$F is 4 l'sso each byte 
containing $FF Indi- 
cates 8 sectors in use. 
The $E is binary 1110 
for three more sectors. 
There are 1 1 ones. 
Decimal 11 Is $OB. the 
first available sector as 
we determined previ- 
ously, the sector where 
the first FIR goes. I 
guess we could think of 
the 1 1 ones as repre- 
senting serial sectors 

00 through $OA mean- 
ing that the next 
available sector ts SOB. 

1 wrote some more files 
to the disk from OS9 
and verified that an- 
other 1 appeared In the 
map for each sector 
used completely or 
paitlally including the 
FIR sector. 

I added the appro- 
priate code to write l's 
to the sector map in the 
SK'DOS program, 
foigetting the extra 1 
for the FiR. I wrote a 
file to the disk and I 
could read it using 
OS9. I wrote a file from 



OS9 and the pievlous 
Hie lost Its end. When I 
fixed my sector count 
for the FIR sector the 
problem was cured and 
I had the whole utility 
running. There was 
still a small problem. 
Since the program read 
the dlrectoiy to find the 
last FIR and then adds 
sectors to find the first 
available one. SK'DOS 
didn't know what to do 
with a freshly formatted 
and blank disk. There 
were no directory 
entries, so It was lost. 
A couple of days later. I 
fixed the program to 
count l's in the sector 
map to find the flist 
sector and to use the 
pointer to find the place 
for the next directory 
entry. Needless to say, 
it worked. 

Listings for the 
three utilities are 
Included with this, 
requires one argument, 
the number of the drive 
containing the OS9 
dtsk. I was tempted to 



default to the working 
drive but that doesn't 
work well with hard 
disk systems, so I 
chose to let the user 
supply the drive num- 
ber. 

OS9COPY requiies 
first the drive number, 
then the track and 
sector of the start of 
the file (as displayed by 
the OS9DIR utility), 
and lastly the name of 
the SK'DOS file. In 
this case working drive 
and .TXT are defaults. 

COS9 requires the 
SK'DOS filename 
(default .TXT and 
working drive) the drive 
number for the OS9 
disk, and the OS9 
filename. FUes from 
SK'DOS written to the 
disk do not make It 
incompatible with OS9 
in any way. Files may 
be tiansferred back 
and forth until the 
"transfer disk* Is full, at 
which point it must be 
reformatted. 



OS9 DISK DIRECTORY PROGRAM 

FORMAT: OS9DIR N WHERE N IS THE DRIVE NUMBER 

OF THE DRIVE CONTAINING A SINGLE SIDED OS9 FORMATTED DISK 

OUTPUT WILL SHOW THE TRACK AND SECTOR FOR 7HE INFORMATION 
RECORD OF EACH FILE.. THIS INFORMATION TO BE USED BY 
AN QS9 TO SK'DOS ASCII FI1£ COPY PROGRAM 





• SK'DOS / 68K 


EQUATES 


00000D00 


OCOLUH 


EOU 


3328 


0000AO2F 


HEXIN 


EQU 


SA02F 


0000A029 


GETCH 


EOU 


SA029 


0000A01C 


SREAD 


EOU 


SA01C 


0000A03B 


OUT4H 


EOU 


SA03B 


000OA034 


PCRLF 


EOU 


SA034 


0000A036 


PNSTRN 


EOU 


SA036 


0000A03S 


PSTRNG 


EQU 


SA035 


0000AG33 


PUTCH 


EOU 


SA033 


0000AD00 


VPOINT 


EOU 


5A000 


0000A01E 


WARMS T 

* 


EOU 


SA01E 




* 

START 


DC 


VPOINT 



Offset from start, of FCB 
Input hex number from command 
Get Input character with echo 

Read a track and sector 

Output A hex digits 

Print CR/LF 
Print string (Without CR/LFt 

Print CR/LF and string 

Output character 

Point to SK'DOS variable area 

Warm start 



GET POINTER 



line 

(7 bits) 
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32 


000002 


224E 








HOVE.L 


A6,A1 


FCB POINTER SAVED IN Al 


33 


000004 


A02F 








DC 


HEXIN 


GET DRIVE NUMBER 


34 


000006 


4A06 








TST.B 


D6 




35 


000008 


6700 


008A{00094 




aso 


HE1P 




36 


oooooc 


1345 


0003 






MOVE.B 


D5.3(A1) 




31 


000010 


337C 


0003 


0022 




MOVE.W 


•$0003, 34 (Al) 


STARTING TRACK AND SECTOR 


38 


000016 


2449 








MOVE.L 


A1.A2 




39 


000018 


D5FC 


0000 


0160 




ADD.L 


1352, A2 


ONE PAST 1AST BYTE OF SECTOR INFO IN FCB 


40 


00001E 


2049 








MOVE.L 


Al, AO 


POINTER TO FCB 


41 


000020 


D1FC 


0000 


OOAO 




ADD.L 


1160, AO 


POINT. AT FIRST BYTE OF FIRST DIR ENTRY 


42 










• NOW READ DIRBCTORY ITBMS USING 


A0 AS POINTER INTO 


43 










• DIRECTORY. 






44 


000026 


2849 






DIRLOP 


MOVE.L 


A1.A4 


A4 MUST POINT AT FCB FOR DISK OPS 


45 


000028 


A01C 








DC 


Sft£AD 




46 


00002A 


OC10 


0000 




SLOOP 


CHP.B 


10. (AO) 


SEE IF BYTE IS NULL 


41 


>00002E 


6700 


002E<0005E 




B£Q 


DONEDR 


WE'RE FINISHED 


46 


>000032 


6100 


002C<00060 




BSR 


PRNTDR 


PRINT AN ENIKY AND TTSS INFORMATION 


49 


000036 


D1FC 


0000 


0020 




ADD.L 


IS20.A0 




50 


00003C 


B5C8 








CMP.L 


A0.A2 




51 


00003E 


66EA 




(0002A 




BNE.S 


SLOOP 


PRINT MORE 


52 










• FINISHED A SECTOR, GET NEXT ONE 




53 


000040 


2049 








MOVE . L 


A1.A0 




54 


000042 


D1PC 


0000 


0060 




ADD.L 


196, AO 




55 


000048 


5229 


0023 






ADD.B 


tl,35(Al) 




56 


00004C 


0C29 


0010 


0023 




CMP.B 


#S10,35(A1) 




57 


000052 


6602 




(00026 




BNE.S 


DIRLOP 


DON'T HAVE TO ADJUST TRACK 


58 


000054 


4229 


0023 






CLR.B 


35(A1) 




59 


000058 


5229 


0022 






ADD.B 


11, 34 (AD 


INCREMENT TRACK 


60 


OOOOSC 


60C8 




(00026 




BRA.S 


DIRLOP 




61 










• 








62 
63 
64 


00005E 


A01E 






DONEDR 


DC 


HARMST 












* 








65 










• SUBROUTINE TO 


PRINT A DIRECTORY 


ENTRY 


66 










# 








67 


>000060 


6100 


0020(00082 


PRNTDR 


BSR , 


PSTR 


PRINT STRING TERMINATED BY NULL 


68 


000064 


183C 


0020 




FLOOP 


MOVE.B 


IS20,D« 




69 


000068 


A033 








DC 


PUTCH 




70 


00006A 


0C29 


0023 


ODOO 




CMP.B 


I35,OCOLUM(A1) 




71 


000070 


60F2 




100064 




BLT.S 


FLOOP 


SPACES TO COL 35 


72 


000072 


3828 


001E 






MOVE.W 


30(A0).D4 


0TTS 


73 


000076 


5C44 








ADO.H 


I6.D4 




74 


000078 


E944 








ASL.W 


14, D4 


0000TTS0 


75 

76 
77 


00007A 


E80C 








LSR.B 


14, D4 


0000TT0S 


0000 7C 


A03B 








DC 


OUT4H 




78 


00007E 


A034 








DC 


PCRLF 




79 


000080 


4E75 








RTS 






80 










■ 








81 










• PRINT 


A NULL 


TERMINATED STRING 




82 










# 








83 


000082 


2648 






PSTR 


MOVE.L 


A0.A3 


USE A3 FOR STRING POINTER 


84 


000084 


181B 






PLOOP 


MOVE.B 


<A3)«.D4 




85 


000086 


0C04 


0000 






CMP.B 


10. D4 




86 


>00008A 


6700 


0006(00092 




BEQ 


PEND 




87 


00008E 


A033 








DC 


PUTCH 




88 


000090 


60F2 




(00084 




BRA.S 


PLOOP 




89 
90 
91 


000092 


4E75 






PEND 


RTS 






000094 


49FA 


0006(000 9C 


HELP 


LEA 


HIPMSGIPC! ,A4 




92 


000098 


A035 








DC 


PSTRNG 




93 
94 
95 


00009A 


A01E 








DC 


HARMST 




00009C 


4F53 


3944 


4952 


HLPMSG 


DC.B 


"OS9DIR must be 


followed by the drive number", SOD. SOA 


96 


G00OC9 


6F66 


2061 


2064 




DOB 


"of a drive containing an OS9 format disk from which*, SOD, SOA 


97 


OOOOFE 


746F 


2072 


6561 




DC.B 


"to read the directory. Directory shows filename 


and', SOD, SOA 
















98 
99 

100 


000134 


7374 


6172 


7469 




DC.B 


"starting track 


and sector of each file.". SOD, SOA, $04 












END 


START 







ERKORS DETECTED 
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1 

2 

3 
4 
5 
6 


















• 0S9 FII£ COPY 

• 


PROGRAM 




* 
* 
E 








• FORMAT: 0S9C0PY N 7TSS FIl£NAr 


7 








• THIS 


UTILITY MILL COPY A FILE 


FROM AN OS9 FORMATTED DISK * 


e 








• (SINGI£ SIDED) 


. TIE 7TSS 


ARE 


TRACK AND SECTOR OF THE FILE • 


9 








* INFORMATION RECORD AS DETERMINED BY THE 0S9DIR UTILITY. ■ 


10 

n 

12 








' N IS 


THE NUMBER OF THE DRIVE CONTAINING THE OS9 DISK. • 








• FILE 


HILL BE COPIED 70 THE 


SK'DOS WORKING DRIVE. * 


13 
14 
15 
16 
17 

le 








* TIE DEFAULT EXTENSION IS . 


TXT 


* 








• SK'DOS / 66K BQUATES FOR USER 


PROGRAMS 




00000000 


OCCLUM 


EQU 


3328 




Offset from start of FCB 


19 




0000A02F 


HEXIN 


EQU 


5A02F 




Input hex number from ccmund line 


20 




0000A023 


GETNAM 


EQU 


5A023 




Get file name from command line 


21 




0000A024 


DEFBX7 


EQU 


5A024 




Default extension 


22 




0000A006 


FOP END 


EQU 


5A006 




Open file for write 


23 




0000A002 


FHRITE 


EQU 


5A002 




Write byte to file 


2A 




0000A008 


FCLQSE 


EQU 


SAOoe 




Close file 


25 






3000A029 


GETCH 


EQU 


SA029 




Get Input character tilth echo (7 bits) 


26 




0000A01C 


SREAD 


EQU 


SA01C 




Read a track and aector 


27 




0000A03B 


OUT4H 


EQU 


5A03B 




Output 4 hex digits 


26 




0000A034 


PCRJf 


EQU 


SA034 




Print CR/lf 


29 






D000A036 


PNSTRN 


EQU 


SA036 




Print string (Without CR/If) 


30 




0000A035 


PSTRNG 


EQU 


5A035 




Print CR/lf and string 


31 




0000A033 


PUTCH 


EQU 


SA033 




Output character 


32 




OOOOAOOO 


VPOINT 


EQU 


SA000 




Point to SK'DOS variable area 


33 

34 
35 




0000A01E 


WARMST 


EQU 


SAO IE 




Warn start 


000000 








ORG 









36 


000000 






OUTFCB 


DS.8 


606 






37 


000260 






OSECTS 


ps.w 


1 






38 


000262 






OBYTES 


OS.B 


1 






39 




00000263 


LAST 


EQU 


# 




. 


40 


000000 








ORG 









41 








* 










42 
43 
44 








* GET 

* 


STUFF FROM COW* LINE REGARDING INPUT FII£ 


000000 


AOOO 




START 


DC 


VPOINT 




GET POINTER 


45 


000002 


224E 






MOVE.L 


A6.A1 




FCB POINTER SAVED IN Al 


46 


000004 


A02F 






DC 


HEXIN 




GET DRIVE NUMBER 


47 


000006 


4A06 






TST.B 


06 






48 


oooooe 


6700 


02F4(002FE 




BEQ 


HEIP 






49 


oooooc 


1345 


0003 




MOVE.B 


OS,3(Al) 






SO 


000010 


A02F 






DC 


HEXIN 




GET TRACK AND SECTOR OF FIR 


51 


000012 


3345 


0022 




MOVE.W 


05, 34 (AD 




STARTING TRACK AND SECTOR 


52 


000016 


2649 






MOVE.L 


A1.A4 




A4 MUST POINT AT FCB FOR DISK OPS 


53 


000018 


A01C 






DC 


SREAD 






54 








• 










55 








* NON GET OUTPU7 


FII£ READY 






56 








* 










57 


00001A 


47FA 


0066(00064 




LEA 


VARS(PC),A3 


POINT A3 AT VARIABLE AREA 


58 


00001E 


49EB 


0000 




LEA 


OU7FCB(A3> 


A4 


POINT A4 AT OUTFCB 


59 


000022 


A023 






DC 


GETNAM 




GET OUTPUT FILE NAME 


60 


000024 


183C 


0001 




M3VE.8 


»1.D4 




DEFAULT TO .TXT EXTENSION 


61 


000026 


A024 






OC 


DEFEXT 






62 


00002A 


A006 






DC 


FOPENW 






63 








* 










64 
65 
66 








• NOW GET INPUT 


FILE SECTOR 


AND 


BYTE COUNT 


00002C 


3769 


006A 0260 




MOVE.W 


106{A1),OSECTS(A3> SECTOR COUNT IN MEMORY 


67 


000032 


1769 


006C 0262 




MOVE.B 


108 (AD .OBYTES (A3) BYTE COUNT FOR LAST SECTOR 


68 


000038 


6100 


02AE(002E6 


READlf 


BSR 


NEXSEC 




NEXT SECTOR 


69 


00003C 


303C 


0100 




MOVE.W 


1256.00 




COUNTER FOR ONE SECTOR 


70 


000040- 


2649 






MOVE.L 


A1.A4 






71 


000042 


2049 






MOVE.L 


A1.A0 






72 


000044 


01PC 


0000 0060 




ADD.L 


196, AO 




POINT AT FIRST BYTE 


73 


00004A 


A01C 






DC 


SREAD 




READ A SECTOR 


74 


00004C 


49EB 


0000 




LEA 


OUTFCB (A3) 


A4 


POINT AT OUTFCB 
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75 


000050 1818 






REA02 


MDVE.B 


(A0) +, 04 




76 


000052 A002 








DC 


FWRITE 


WRITE BYTE TO OUTPUT FILE 


77 


000054 5340 








SUB.N 


11.00 


BYTE COUNT 


78 


000056 66F8 


(00050 




BNE.S 


READ2 




79 


000058 536B 


0260 






SUB.W 


tl.OSECTS(A3) 




eo 


00005C 66DA 


(00038 




BNB 


READ LP 




81 








• DONE 


READING 


WH01E SECTORS 




62 


00005E 6100 


0288(00288 




BSR 


NEXSEC 


GO TO LAST SECTOR 


83 


000062 4240 








CLR.N 


DO 




84 


000064 102B 


0262 






MOVE.B 


OBYTES (A3), DO 




85 


000068 2849 








MOVE.L 


Al,A4 




86 


00006A 2049 








MOVE.L 


A1.A0 




87 


00006C 01FC 


0000 


0060 




ADO. I. 


I96.A0 




88 


000072 A01C 








DC 


SREAD 




89 


000074 49EB 


0000 






LEA 


OUTFCB(A3),A4 


SET A4 TO POINT AT FCB 


90 


000078 1818 






READ3 


KJVE.B 


(AO) *, D4 




91 


00007A A002 








DC 


FWRITE 




92 


00007C 5340 








SUB.W 


11, DO 




93 


00007B 66F8 




00078 




BNE.S 


REA03 




94 


000080 A008 








DC 


ECLOSE 


CLOSE OUTPUT FILE 


95 


000082 A01E 








DC 


WARMST 




96 








• VARIABLE ARE* 






97 


000084 






VARS 


DS.W 





DUMMY TO CAUSE WORD ALIGNMENT 


98 
99 

100 


000084 








DS.B 


1AST 


RESERVE BYTES FOR VARIABLES HERE 








• SUBROUTINE KEXSEC NEXT SECTOR 




101 








ft 








102 


0002E8 5229 


0023 




N EX SEC 


ADD.B 


I1,35(A1) 




103 


0002EC 0C29 


0010 


0023 




CMP .8 


($10. 35 (AD 


END OF TRACK 


104 


0002F2 6608 




002FC 




BNE.S 


DON SEC 




105 


0002F4 4229 


0023 






CLR.B 


35<A1) 


SECTOR ZERO 


106 


0002F8 5229 


0022 






ADQ.B 


11, 34 (Alt 


NEXT TRACK 


107 


0002FC 4E75 






OONSBC 


RTS 






108 
















109 


0002FB 49FA 


0006(00306 


HELP 


LEA 


HLPMSG(PC) ,A4 




110 


000302 A035 








DC 


PSTRNG 




111 


000304 A01E 








DC 


WARMS T 




112 
















113 


000306 466F 


726D 


6174 


H1PHSG 


DC.B 


"Format: OS9COPY 1 0101 SKFILENAME", SOD, SOA 


114 


000329 4F53 


3943 


4F50 




DC.B 


■OS9COPY copies 


a text file from an OS9 formatted*. S00, SOA 


115 


00035B 6469 


736B 


2E20 




DC.B 


"disk, The single digit following OS9COPY is the", $00, SOA 


116 


00038D 6C6F 


6769 


6361 




DC.B 


"logical drive 


number for the drive containing the". $00, SOA 


117 


0003CO 4F53 


3920 


6469 




DC.B 


•OS? disk. The 


four digit number is the track and", SOD, SOA 


lie 


0003F3 7365 


6374 


6F72 




DC.B 


"sector number 


of the OS9 file as determined by the", SOD, SOA 


119 


000427 4F53 


3944 


4952 




DC.B 


-OS90IR utility 


The SKFIIENAME defaults to the", SOD, SOA 


120 


000458 776F 


726B 


696E 




DC.B 


"working drive 


and .TXT extension.", SOD, SOA, S04 


121 
















122 










END 


START 






1 
2 


ERRORS DETECTED 












3 

4 
5 
6 








* COPY 


SK'DOS FILE TO OS9 DISK PROGRAM • 








• FORMAT: COS9 


SKFILENAME DR OSFILENAME WHERE OR IS t • 


7 
8 
9 








• OF THE DRIVE 


CONTAINING A SINGLE SIDED OS9 FORMATTED DISK • 








• THIS 


PROGRAM 


WILL WRITE THE FILE TO TNE DISK AND MAKE A • 


10 
11 
12 
13 
14 
15 








• FIR SECTOR AND DIRECTORY ENTRY 


FOR ONE FIIE AT A TIME * 








* SK'OOS / 68K 


■QUATES FOR USER 


?R0GRAM5 




OOOOODOO 


OCOLUH 


EQU 


3328 


Offset from start of FCB 


16 




000002EE 


CHDWTH 


EQU 


750 


Month byte binary 


17 




000002EF 


CDAY 


EQU 


751 


Day byte binary 


18 




000002FO 


CYEAR 


ECU 


752 


Year byte binary 


19 




0OOOAO3F 


GETDNT 


EQU 


SA03F 


Get date and time 


20 




OOOOA02F 


HEX IN 


EQU 


SA02F 


Input hex number from command line 


21 




0000A029 


GETCH 


ECU 


SAO 2 9 


Get Input character with echo (7 bits) 


22 




0000A023 


GETNAM 


EQU 


SA023 


Get filename from conmand lint to FCB 


23 




0OOOAO2D 


GETNXT 


eou 


SA020 


Get next char of command line 



24 
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24 




0000A024 


OEFEXT 


EQU 


SA024 


■ 
Default extension 


2S 




0000A005 


FOPENR 


EQU 


SAD05 


Open file foe read 


26 




0000A008 


FCLOSE 


EOU 


SA008 


Close file, A4 points at FCB 


27 




0000A001 


FREAD 


EQU 


SA001 


Read char from file open for read 


28 




0000A002 


PWRITE 


EQU 


SA002 


Write char to file open for write 


29 




0000A037 


P ERROR 


EQU 


SA037 


Print file error message 


30 




0000A01C 


SREAD 


EQU 


SA01C 


Read a sector 


31 




0000A01D 


S WRITE 


EOU 


SAO ID 


Write a sector 


32 




0000A03B 


0UT4H 


EQU 


SA03B 


Output 4 hex digits 


33 




0000A034 


PCRLF 


EOU 


SA034 


Print CR/LF 


34 




0000A036 


PNSTRN 


EQU 


SA036 


Print string (Without CR/LF) 


35 




0000A03S 


PSTRNG 


EQU 


SA035 


Print CR/LF and string 


36 




0000A033 


PUTCH 


EQU 


SA033 


Output character 


37 




OOOOAOOO 


VPOIHT 


EQU 


SA000 


Point to SK'DOS variable area 


38 
39 




0000A01E 


HARHST 

* 


BQU 


SAO IE 


Warn start 


40 
41 
42 
43 






■ 

• GET SK*0OS FILENAME FROM COMMAND LINE AND OPEN FOR READ 


000000 


49FA 033E100340 


START 


LEA 


INFCB(PC),A4 




■44 


000004 


A023 




DC 


GETNAM 




45 


000006 


6500 0216(00226 




BCS 


HELP 




46 


00000A 


183C 0001 




MOVE.B 


11. D4 




47 


OOOOOE 


A024 




DC 


OEFEXT 




48 


000010 


6500 0210(00222 




BCS 


ERROR 




49 


000014 


A005 




DC 


FOPENR 




50 
51 
52 


000016 


6S00 020AI00222 




BCS 


ERROR 








* MOW GET OS9 DRIVE NUMBER 




S3 
54 

55 






• LEAVE 


OS9 FIIENAME FOR LATER 




00001A 


AOOO 




DC 


VPOINT 


GET POINTER 


56 


00001C 


284E 




MOVE.L 


A6,A4 


FCB POINTER 


57 


00001E 


A02F 




DC 


HEXIN 


GET DRIVE NUMBER 


58 


000020 


194S 0003 




MOVE.B 


D5, 3<A4) 




59 






* SET UP BUFFER 


POINTER LIMIT (END OF SECTOR BUFFER) 


60 


000024 


244C 




MOVE.L 


A4.A2 


FIRST SET UP SECTOR BUFFER LIMIT 


61 
62 
63 


000026 


D5FC 0000 0160 


* 


ADO.L 


1352, A2 


ONE PAST LAST BYTE OF SECTOR INFO IN FCB 






* GET POINTER TOR NEXT DIRECTORY 


ENTRY 


64 
65 
66 






• FROM 


BYTES 11 


AND 12 OF seCTOR 


0002 AND SAVE IT IN DIRTS 


00002C 


204C 




MOVE.L 


A4,A0 


POINTER TO FCB 


67 


00002E 


01FC 0000 0060 




ADO.L 


196, AO 


POINT AT FIRST BYTE OF FIRST 0IR ENTRY 


68 


000034 


397C 0002 0022 




MDVE.W 


IS0002,34(A4) 


POINT AT SECTOR CONTAINING 0IR PTR 


69 


00003A 


A01C 




X 


SREAD 


READ THE INFO SECTOR 


70 


00003C 


4280 




CIR.L 


00 




71 


00003E 


1028 OOOB 




MOVE.B 


11(A0),D0 


WORD MISALIGNED IN BUFFER 


72 


000042 


E140 




ASL.W 


• 8, DO 




73 


000044 


1028 OOOC 




MDVE.B 


12<A0),D0 


GET LO ORDER BYTE OF WORD 


74 


000048 


0640 0300 




AOD.W 


IS0300,D0 


DIR STARTS AT SECTOR 3 0SBB 


75 


00004C 


47FA 02EE10033C 




I£A 


DIRTS (PC), A3 




76 
77 
78 


000050 


3680 


* 


MOVE.W 


DO, (A3) 


SAVE IN DIRTS 






* FIND 


NEXT AVAILABLE SECTOR FROM SECTOR BIT MAP 


79 
80 

81 






• IN 0001 BY COUNTING BITS 

* 




0000S2 


4280 




CIR.L 


DO 




82 


000054 


4281 




CIR.L 


Dl 




83 


000056 


4282 




CIR.L 


D2 




84 


000058 


397C 0001 0022 




MOVE.W 


150001,34 |A4) 




85 


oooose 


A01C 




DC 


SREAD 




86 


000060 


2018 




MOVE.L 


(A0)4,D0 




87 


000062 


343C 0020 


FNOO 


MOVE.W 


132,02 




88 


000066 


E380 


FN01 


ASL.L 


11, DO 




89 


000068 


640A (00074 




BCC.S 


DONFND 




90 


00006A 


S241 




ADO.W 


11,01 


SECTOR COUNT 


91 


00006C 


S342 




SUB 


11, D2 


COUNTER FOR LONG WORD 


92 


0000 6E 


66F6 (00066 




BNE 


FND1 




93 


000070 


2018 




MOVE.L 


(A0)+,D0 


GET FOUR MORE BYTES OF SECTOR MAP 


94 


000072 


6CEE 100062 




BRA 


FNDO 


RELOAD LONG WORD COUNT 


95 


000074 


47FA 02C2( 00338 


DONFND 


LEA 


FIRSEC(PC),A3 




96 


000078 


5C41 




ADO.W 


16, Dl 


SECTOR COUNT TO TRACK SECTOR CONVERT OTIS 


97 


00007A 


E941 




ASL.W 


14,01 


TTS0 
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25 



96 


00007C 


E809 










I.SR.B 


14,01 


TTOS 




99 


00007E 


3681 










MOVE.W 


01, (A3) 


SAVE FOR IATER 




100 










* 












101 










* 


GET 


READY TO WRITE FIRST SECTOR 


OF DATA 




102 










* 












103 


000080 


3941 


0022 








MOVE.W 


D1,34(A4> 


PUT IN FCB 




104 


000084 


61D0 


018610020C 






BSR 


NEWTS 


GET NEXT SECTOR AS FIRST WRITE SECTOR 




105 


000088 


204C 










MOVE.L 


A4,A0 






106 


00008A 


D1FC 


0000 


0160 






ADO.l, 


1352, AO 


POINT AO AT SECTOR DATA (0+256) 




107 


000090 


4280 










CLR.L 


DO 


SET UP AS BYTE COUNTER 




ioe 


000092 


91FC 


0000 


0100 


OOSECT 


SUB. I 


1256, AO 


RESET TO START OF BUFFER 




109 


000098 


49FA 


02A6{00340 






LEA 


INFCB (PC) ,A4 


POINT A4 AT SK INPUT FILE FCB 




110 










> 












in 










* 


WRITE A SECTOR 


LOOP FOLLOWS 






112 










* 












113 


00009C 


A001 






SECT 


DC 


FREAD 


READ A CHAR 




114 


00009E 


6614 




(000B4 






BNE.S 


DONWRT 


ASSUME ERROR IS EOP 




115 


OOOOAO 


5280 










ADO.l. 


11, DO 


BYTE COUNTER 




116 


0000A2 


IOCS 










MOVE.B 


D5, (A0) + 


PUT IN OUTPUT SECTOR BUFFER 




117 


0000A4 


BSCB 










CMP.L 


A0.A2 






118 


0000A6 


66F4 




0009C 






BNE.S 


SECT 






119 


0000A8 


AOOO 










DC 


VPOINT 






120 


OOOOAA 


284E 










MOVE.L 


A6,A4 


POINT AT OUTPUT BUFFER 




121 


OOOOAC 


A01D 










DC 


S WRITE 


WRITE THE SECTOR 




122 


OOOOAB 


6100 


015CI0020C 






BSR 


NEWTS 


NEXT TRACK AND SECTOR 


• 


123 


000032 


60DE 




00092 






BRA 


DOSECT 






124 










■ 












125 










* 


NOW 


HANDLE LAST PARTIAL SECTOR 






126 










■ 












127 


0000B4 


AOOO 






DONWRT 


DC 


VPOINT 






128 


OOOOBfi 


284E 










MOVE.L 


A6.A4 






129 


0000B8 


lore 


00E5 




DLOP 


MOVE.B 


ISE5, <A0) + 


. 




130 


OOOOBC 


B5C8 










CMP.L 


A0,A2 






131 


OOOOBE 


66F8 




(OO0B8 






BNE.S 


DLOP 


FILL END OF BUFFER WITH SE5 




132 


OOOOCO 


A01D 










DC 


SWRI7E 






133 










* 


NOW 


SET UP FIR 


DATA FOR WRITS 






134 










» 


FIR 


TRACK AND 


SECTOR IN FIRSEC 






135 










* 


LAST 


TRACK SECTOR WRITTEN IN 34 (A4) 




136 










* 


BYTE 


COUNT (SATE AS SECTORS * BYTES) IN DO 




137 










» 


GET 


POINTER TO 


FCB AND SECTOR DATA (0) 




138 


OO00C2 


AOOO 










DC 


VPOINT 






139 


0000C4 


204E 










MOVE.L 


A6.A0 






140 


0000C6 


OOFC 


0060 








ADD 


196, AO 


POINT AT START OF SECTOR INFO 




141 










* 


NOW 


STUFF FIR 


WITH ALL THE NECESSARY DATA 




142 


OOOOCA 


10FC 


003F 








MOVE.B 


IS3F, (A0) + 


-EWREHR 00 PROTECTION CODES 




143 


OOOOCE 


10PC 


0000 








MDVE.B 


10, (A0) + 


01 




144 


0000D2 


10FC 


0000 








MOVE.B 


10, (A0) + 


02 




145 


0000D6 


10EE 


02F0 








MOVE.B 


CYEAR{A6), IA0) + 


03 DATE 




146 


OOOOOA 


10EE 


02EE 








MOVE.B 


CMONTHIA6), (AO) + 


04 




147 


OOOOOE 


10EE 


02EF 








MOVE.B 


CDAY(A6), (AO)* 


05 




148 


0000E2 


A03F 










DC 


GETONT 


OOHMMHSS IN D6 SET DATE AND TIME 




149 


0000E4 


2206 










MOVE.L 


D6.D1 


KEEP IT SAFE FROM SK'DOS 




150 


O000E6 


4841 










SWAP.W 


Dl 


MHSSOOHH IN Dl 




151 


0000E8 


10C1 










MOVE.B 


01, (A0) + 


06 




152 


OOOOEA 


E199 










ROL.L 


18,01 


SSOOHHMM IN Dl 




153 


OOOOBC 


10C1 










MOVE.B 


Dl, (AO) + 


07 




154 


OOOOEE 


30FC 


0100 








MOVE.W 


IS0100, (A0) + 


08-09 




155 


0000F2 


E098 










ROR.L 


18, DO 


BB000SSS IN DO 




156 


0000F4 


30CO 










MOVE.W 


DO, (AO)* 


SECTORS OA-OB 




157 


0000F6 


E198 










ROL, . L 


18, DO 






158 


0000F8 


10C0 










MOVE.B 


DO, (AO)* 


BYTES IN PARTIAL SECTOR OC 




159 


OOOOPA 


10EE 


02FO 








MOVE.B 


CYEAMA6), <A0) + 


OD DATE AGAIN 




160 


OOOOFE 


10EE 


02EE 








MOVE.B 


CMONTH(A6), (AO) + 


OE 




161 


000102 


10EE 


02EF 








MOVE.B 


CDAYIA6), (AO)* 


OF 




162 


000106 


10FC 


0000 








MOVE.B 


10, (AO)* 


10 




163 


00010A 


323A 


022C{00338 






MOVE.W 


FIRSEC IPC), Dl 


STORED AS TTSS 




164 


00010E 


3D41 


0022 








MOVE.W 


D1,34(A6) 






165 


000112 


5B41 










sua.w 


15,01 


CONVERT TO SECTOR NUMBER 




166 


000114 


E909 










ISL.B 


14, Dl 


COMPRESS 




167 


000116 


E849 










LSR.W 


14, Dl 


OPPOSITE OF TAKE APART 




168 










* 












169 










* 


PUSS 


BECAUSE WORD IS NOT WORD ALIGNED IN SECTOR BUFFER 




170 










* 












171 


000118 


E099 










ROR.L 


18, Dl 


HI ORDER BYTE 
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172 


00011A 


10C1 










MOVE.B 


Dl, (A0> + 




11 




113 


00011C 


E199 










ROL.L 


»8,D1 








174 


00011E 


10C1 










MOVE.B 


Dl, (A0) + 




12 




175 


000120 


E09B 










ROR.L 


• 8, DO 




SAME DEAL HITH TOTAL SBCTORS 




176 


000122 


5240 










ADD.H 


11, DO 




ADD 1 FOR PARTIAL SECTOR 




177 


000124 


43FA 


0218(0033E 






LEA 


SCOUNT (PC) 


, Al 






178 


000128 


3280 










MOVE.H 


DO, (AD 




SAVE TOTAL SECTOR COUNT 




179 


00012A 


E098 










ROR.L 


18, DO 








ieo 


00012C 


10C0 










MOVE.B 


DO, (A0) + 




13 




181 


00012E 


E198 










ROL.L 


18, DO 








182 


000130 


10C0 










MOVE.B 


DO, (AO) + 




14 




183 


000132 


10FC 


0000 








MOVE.B 


10, (A0) + 




TO PUT IN WORD ALIGNMENT 15 




184 


000136 


30FC 


0000 




FIRLOP 


MOVE.M 


10, (A0)» 




16-FF 




185 


00013A B5C8 










CMP.L 


A0.A2 








186 


00013C 


68F8 




00136 






BNE.S 


FIRLOP 








187 


00013E 


A01D 










DC 


SNRITE 




HRITE FIR SECTOR TO DISK 




188 










» 














189 










* 


WRITE 


THE DIRECTORY ENTRY 


FOR 


FU£ 




190 










* 














191 


000140 


303A 


01FA(0033C 






MOVE.M 


DIRTS (PC), 


DO 


SSBB PTR 




192 


000144 


E048 










LSR.H 


• 8, DO 




OOSS 




193 


000146 


3940 


0022 








MDVE.W 


D0,34(A4) 








194 


00014A 


303A 


01F0(0033C 






MOVE.M 


DIRTS (PC), 


DO 


SSBB 




195 


00014E 


0240 


OOFF 








AND.H 


»SOOFF,00 




OOBB 




196 


000152 


204C 










MOVE.L 


A4,A0 








197 


000154 


D1FC 


0000 


0060 






ADD.L 


196, AO 




START OF SECTOR BUFFER 




198 


000 ISA 


D1C0 










ADD.L 


DO.AO 




NOH POINTS AT DIRECTORY ENTRY IN SEC. 


BUF 


199 


00015C 


A01C 










DC 


SREAO 




GET THE SECTOR 




200 


00015E 


4280 










Clfl.L 


DO 








201 


000160 


303A 


0106(00338 






MOVE.M 


FIRSEC1PC) 


,D0 






202 


000164 


E900 










ASL.B 


• 4, DO 








203 


000166 


E848 










LSR.H 


#4, DO 




COMBINE TRACK AND SECTOR 




204 


000168 


SD40 










SUB.H 


16, DO 








205 


000 16A 


3140 


001E 








MOVE.M 


D0,30fA0) 




FIR SECTOR NUMBER 




206 


00016E 


A02D 






NAMLOP 


DC 


GETNXT 








207 


000170 


OC05 


OOOD 








CUP. a 


#S0D,D5 








208 


000174 


6704 




(0017A 






BEQ.S 


ENDNAM 








209 


000176 


10C5 










MOVE.B 


D5, (A0)+ 








210 


000178 


60F4 




I0016E 






BRA-S 


NAHIOP 








211 


00017A 


0028 


0080 


FFFF 


ENDNAM 


OR.B 


#S80,-1(A0) 


SET HI ORDER BIT LAST CHAR 




212 


000180 


A01D 










DC 


SWRITE 








213 










* 














214 










» 


GO FIX DIRECTORY POINTER 








215 










* 














216 


000182 


284E 










MOVE.L 


A6,A4 




MAKE SURE POINTER IS THERE 




217 


000184 


397C 


0002 


0022 






MOVE.M 


»S0002,34lA4) 






218 


00018A 


A01C 










DC 


SREAD 




GET SECTOR 




219 


oooiec 


204C 










MOVE.L 


A4,A0 








220 


00018E 


D1FC 


0000 


0060 






ADD.L 


I96.A0 




POINT AT SECTOR DATA 




221 


000194 


4280 










CLR.L 


DO 








222 


000196 


1028 


OOOB 








MOVE.B 


11(A0),D0 








223 


00019A 


E148 










LSL.M 


18, DO 




HI ORDER DIR PTR 




224 


00019C 


1028 


OOOC 








MOVE.B 


12 (AO) ,D0 








225 


0001A0 


0640 


0020 








ADD.W 


#520, DO 




POINTER FOR NEXT DIR ENTRY 




226 


000 1A4 


1140 


OOOC 








MOVE .B 


DO, 12 (AD) 








227 


0001A8 


E048 










LSR.H 


• 8, DO 








228 


0001AA 


1140 


OOOB 








MOVE.B 


DO, 11 (AO) 








229 


0001AE 


A01D 










DC 


SHRITE 








230 










* 














231 










* 


NOW CROSS OUT 


SECTORS IN 


THE 


SECTOR MAP 




232 










» 














233 


0001B0 


204C 










MOVE.L 


A4.A0 




GET POINTER 




234 


0001B2 


DOFC 


0060 








ADD 


•96, AO 




POINT AT DATA AREA IN FCB 




235 


0001B6 


397C 


0001 


0022 






MOVE.M 


#50001, 34(A4) 


TRACK SECTOR 1 




236 


0001BC 


A01C 










DC 


SREAD 








237 


0001BE 


323A 


017E(0033E 






MDVE.H 


SCOUNT IPC) 


,D1 






238 


0001C2 


5241 










ADD.W 


ll,Dl 




FOR FIR SECTOR ADD'L TO DATA SECTORS 




239 










* 


FIND 


FIRST BYTES IN MAP THAT 


CONTAIN ZEROS 




240 


0081C4 


2010 






LI 




MOVE.L 


<A0),D0 








241 


0001C6 


0C40 


FFFF 








CMP.W 


KSFFFF.DO 








242 


0001CA 


6604 




001D0 






BNE.S 


L3 








243 


0001CC 


5488 










ADD.L 


»2,A0 








244 


0001CE 


60F4 




001C4 






BRA 


LI 








245 










• 


SHIFT l'S IN 


UNTIL ALL 1' 


S Of 


SECTOR COUNT IS ZERO 
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SCULPTOR 

From Ihc world's oldest A largest OS-9 
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CUTS I'llOGIlAMMLWG TIME tl» TO 80% 
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*$ 1,990 $398 $795 



FC/XT/AT/M8DO8 $695 $139 $299 



MUSTANG-08 *$1.295 $259 $495 Call or write for prices on the following systems. 

XENIX SYS III A V. MS-NET. UNIX SVS III A V. ATARI OS- 9. 68K. UNOS. ULTR4X/VMS (VAX.RECAIJ. STWDG. AI.TOS. APRICOKr. ARETE. ARM- 
STRONG. BUEASDALE . CHARLES RIVERS. GMX. CONVERG.TECH. DEC. CIFER. EQUINOX. GOULD. IU'. HONEYWt:LL. IBM. INTEL. MEGADATA. 
MOTOROLA. NCR. N XDORK. N.SPAR. OLIVETTI /AT4T. ICL. PERKINS ELMER. PHILLIPS. PIXEL. PI.ESSEV. KXXUS. POS11HON. PRIME. SEgUEwr. 
SIEMENS. SWTPC . SVSTIME. TANDY . TORCH. UNISYS. ZYLOO. ETC 

* For SPECIAL LOW SCULPTOR prices especially for 68t»*ti8XXX OS-9 Systems - See Sptv 
clal <%d this IsNite. Remember, **W hen they are gone Ihe price goes bach up as above!** 

... Sculptor Will Run On Over 100 Other Types of Machines ... 
... Call for Pricing ... 

!!! Please Specify Your Make of Computer and Operating System !!! 
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ASSEMBLERS 

ASTRUK09 from S.E- Media - A "Structured Assembler for the 6809" 
which require! the TSC Micro Assembler. 
F, S, CCF ■ $99.95 
Micro Assembler for TSC - The FLEX, SK'DOS STANDARD 
Assembler. 

Special -CCF 135.00; F. S 150.00 
OSM Extended 6809 Micro Assembler from Uoyd I/O. •• Provides local 
Ubels. Motorola S-reaordi, and Intel Hex records; XREF. Generate 
OS.9 Memoiy modules under FLEX, SK'DOS. 
FLEX, SK'DOS, CCF, OS-9 $99.00 
Relocating Assembler/Linking Loader from TSC. -- Use with many of the 
C and Pascal Compilers. 
F. S, CCF 1150 00 
MACE, by Graham Troll from Windrush Micro Systems - Co Resident 
Editor and Assembler fan interactive A.L Programming for small lo 
medium-sizad Program!. 
F.S.CCF S75W 
XMACE MACE w/Cross Assembler for 6800/1/2/3/8 
F. S. CCF ■ $9800 

DISASSEMBLERS 

SUPER SLEUTH from Computer Systems Consultants Interactive 
Disassembler; extremely POWERFUL' Disk File Binary/ASCII 
Exam ine/Change. Absolute or FULL Disassembly. XR F-F General or. 
Label "Name Changer", and Files of "Standard Label Names" Tor 
different Operating Systems. 

Color Computer SS-50 Bus tail wt At Source) 

CCD I32K Head) Obj. Only 14900 

F. S, $9900 - CCF, Obj Only $50.00 U. $100 00 

CCF. wISourct $9900 O. $101 00 

CCO.Obj Only$S0O0 

OS9 68K Obj. $100.00 w/Source $20000 
DYNAMITE* - Excellent standard "Batch Mode" Disassembler. Includes 
XREF Generator and "Standard Label" Files. Special OS-9 options w/ 
OS-9 Version. 

CCF, Obj Only $100.00 CCO, Obj. $ 59.95 

F.5. " " $100.00 O.ob/ea only $ I SOW 

U, " " $30000 

CROSS ASSEMBLERS 

TRUE CROSS ASSEMBLERS from Computer Systems Consultants -- 
Supports 1 802/5, Z-80, 6800/1/2/3/8/1 1/HCI 1 . 6804. 680S/HC05/ 
I4680S, 68O9AXV0I , 6502 family. 808013, 8O20/1/2/35/C35/39/ 40/48/ 
C48/49/C49/50/8748/49. 803 1/5 1/875 1, and 68000 Systems. 
Assembler and listing formats same as target CPU's fonnat. Produces 
machine independent Motorola S-TexL 
68000 or (5809. FLEX, SK'DOS, CCF. OS-9. UniFLEX 

any objtel or sourct each - J50 .00 

any 3 objtel or source each ■ $100.00 

Set of ALL object $20000 - wliource $50000 
XASM Cross AJBevblen for FLEX. SK'DOS from S.E MEDIA - This 
set of 6800/1/2/3/5/8, 6301. 6502. 8080/5. and Z80 Cross Assemblers 
uses the familiar TSC Macro Assembler Command Line and Sounx 
Code format. Assembler options , etc.. in providing code for the target 
CPUs. 

Complete set. FLEX, SK'DOS only ■ $150.00 



CPU TYPE 


- Price each: 


For MOTOROLA INTEL 


FLEX9 


$150 $150 


SK'DOS 


$150 $150 


OS9/6809 


$150 J150 


OS9/68K 




CRASMB 16.32 from UjOYD I/O 



CRASMB from LLOYD I/O -- Supports Motorola's. Intel's. Zilog's, and 
others CPU syntax rorlhese 8-Bii microprocessors: 6800. 6801. 6303. 
6804,6805.6809.6811 (all varielies); 6502. 1802/5.8048 family. 8051 
family. 8080/85. Z8.Z80. and 7MS-7O00 family. Has MACROS, 
Loo] Labels, Label XREF. Label Length lo 30 diars. Object code 
formats: Motorola S-Records (text), Intel HEX -Records (text), OS9 
(bin*iy),and FLEX, SK*DOS (binaiyX Written in Assembler ... e.g. 
Ve" Fast. 

ke each: 

OTHER COMPLETE SEI" 
J 150 $399 

$150 $399 

$150 $399 

$432 

- Supports MotaraJa s 68000, and has 
same features as the 8 bit version. OS9/68K Object code Fatmai allows 
this cross assembler lo be used in developing your progiams for OS9/ 
68K on your OS9/6809 computer 

FLEX, SK'DOS, CCF. OS-9/6809 $249 00 



COMMUNICATIONS 

CMODEM Telaaornm unicauons Program from Computer Systems 

Consultants. Inc. ■■ Menu-Driven; supports Dumb-Teiminal Mode. 
Upload and Oownload in non protocol mode, and the CP/M "Modem 7" 
Qinstenscn protocol mode to enable communication capabilities for 
almost any requirement. Written in "C". 

FLEX. SK'DOS. CCF, OS-9, UniFLEX, 68000 & 6809 with 
Source $100.00 . without Source $50.00 
X-TALK from S.E. Media ■ X TALK consists of two disks and a special 
cable, the hookup enables a 6809 SWTFC computer to dump UmFLEX 
files directly to the UniFLEX MUSTANG 020. This is the ONLY 
currently available method to transfer SWTPC 6809 UniFLEX files to a 
68000 UniFLEX system. Gimix 6809 users may dump a 6809 
UniFLEX file to a 6809 UniFLEX five inch disk and it is readable by 
the MUSTANG-020. The cable is specially prepared with internal 
connections to match the non-sundani SWTPC SO/9 HO Db25 
connectors. A special SWTPC S-t cable set is alto available. Users 
should specify which SWTPC system he/she wislics to communicate 
with the MUSTANG-020. The X-TALK software is furnished on two 
disks. One eight inch disk contains S.E. Media modem program C- 
MODEM (6809) and the other disk is a MUSTANG-020 five inch disk 
with CMODEM (68020). Text and binaiy files may be directly 
Iransfened between the two systems. The C-MODEM programs are 
unaltered and peiform as excellent modem programs also. X-TALK 
can be purchased with or without the special cables, but Ihis special 
price is available to registered MUSTANG-020 useis only. 

X-TALK Complete (cable. 2 disks) $99 95 

X TALK Software (2 Juts only) $69.95 

XTAUC with CMODEM Source $149 95 
XDATA from S.E. Madia - A COMMUNICATION Package for the 
UniFLEX Operating System- Use with CP/M. Mam Frames, other 
UniFLEX Systems, etc. Verifies Transmission using chacksum or 
CRC; Re-Tnuunuis bad blocks, etc. 

V - $299 99 



AT«]laMUIr If*** 
O.USJ«,S.MODOi 
V ■ FLEX, 1 ' . InlHM 
COt ■ Gaiar CaatrMite r OS.f 
CCF ■ Goto CMipultr FUJX 
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" Shipping •• 
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PROGRAMMING LANGUAGES 

PIJ9 from Wiudnish Micro Systems - By Giahtm Trot: A combination 
Ediior Compiler Debugger. Diirci lourceto object compilation 
delivering fut, compact, re-entrant. ROM-aNe, PIC. 8 £ 16-bit 
Imegeri & 6 digit Real numbers for all real-world pioblemi. Ouecl 
control over ALL Syitcm resources, including interrupts. 
Comprehensive library support; simple Machine Code interface; step- 
by-step Iraoer for instant debugging. 500+ page Manual with tutorial 
guide. 

F . S. CCF • 1198.00 

PASC from S.E. Media - A FLEX9. SK'DOS Compiler with a definite 

Pascal "flavor" . Anyone with a bit of Pascal experience should be able 
10 begin using PASC to good effect in short order. The PASC package 
comes complete with three sample programs: ED (a syntax or structure 
ediior). EDITOR (a simple, public domain, screen aditor) and CHESS 
(a simple chess program). The PASC package comes complete with 
source (wr uen in PASC) and documentation. 
FLEX. SK'DOS S95DO 

WHIMSICAL from SB. MEDIA Now supports Real Numbers "Slruclurad 
Programming" WITHOUT losing the Speed and Control of Assembly 
Language! Single-pass Compiler features unified, user-defined I/O; 
produces ROMable Code; Procedures and Modules (including pre- 
compiled Modules); many "Types' up to 32 bit Integers, 6 digit Real 
Numbers, unlimited sized Arrays (vectors only); Interrupt handling; 
long Variable Names; Variable Initialization; Include directive; 
Conditional compiling; direct Code insertion; control of the Stack 
Pointer, etc Run-Time subroutines inserted as called duiing 
compilation. Normally products 10% leu code than PU9. 
F.SandCCF-tl9S.OO 

KANSAS CITY BASIC from S.E. Media - Basic /or Color Computer 0S9 
with many new commands and sub-functions added. A full 
implementation of the IF-THEN-EL5E logic is included, allowing 
nesting to 255 levels. Strings are supported and a subset of the usual 
suing functions such as LEFTS, RIGHTS, MIDS. STRINGS, etc are 
included. Variables are dynamically allocated Also included are 
additional features such as Peek and Poke. A must for any Color 
Computer user running OS-9. 
CoCo OS 9 S39 95 

C Compiler from YVIndrush Micro Systems by James McCosh. Full C for 
FLEX. SK'DOS except bit-fields, including an Assembler. Requires 
the TSC Relocating Assembler if user desires lo implement his own 
Libraries. 

F.SandCCF-S295jOO 

C Compiler from Intro! - Full C except Doubles and Bit Fields. 

sueamuTvad for the 6809. Reliable Compiler FAST. efficient Code. 
More UNIX Compatible than most, 

FLEX. SK'DOS. CCF. OS 9 (Level!! ONLY). V - SS75M 

PASCAL Compiler from Lucldata - ISO Based P-Code Compiler. 
Designed especially for Microcomputer Systems. Allows linkage to 
Assembler Code for maximum flexibility. 

F. S and CCF 5' - SI90.00 F. S «"- S205.00 

OmegtSofl PASCAL from Certified Software - Extended Pascal for 
systems and real-lime prognunmin g. 

Native 6803068080 Compiler. S575 for base package, options available. 
For OS/-9/68000 and PDOS host syitcm. 

6809 Cross CornpUer (OS -9/68000 host) S700 for complete package. 



KBASIC - from S.E. MEDIA - A "Native Code* BASIC Compiler which is 
now Fully TSC XBAS1C compatible. The compiler compiles to 
Assembly Language Sourac Code. A NEW. sitramWd , Assembler is 
now included allowing the assembly of LARGE Compiled K-BASIC 
Programs. Conditional assembly reduces Run-lime package. 
FLEX. SK'DOS. CCF, OS-9 Compiler I Assembler S99 00 

CRUNCH COBOL from S.E. MEDIA - Supports large subset of ANSI! 
Level 1 COBOL with many of the useful level 2 features. Full FLEX. 
SK'DOS File Structures, including Random Filet and the ability lo 
process Keyed Files. Segment and link large programs at runtime, or 
implemented as a set of overlays. The System requires 56K and CAN 
be run with a single Disk System, A very popular product. 
FLEX.SK'DOS.CCF ■ S99.95 

FORTH from Stearns Electronic! •• A CoCo FORTH Programming 
Language. Tailored to the CoCol Supplied on Tape, transferable to 
disk. Written in FAST ML. Many CoCo functions (Graphics, Sound, 
etc.). Includes an Editor. Trace, etc Provides CPU Cany Flag 
accessibility. Fast Task Multiplexing, Clean Interrupt Handling, etc. for 
the'Pio". E-cellcnt "Learning" looll 
Color Computer ONLY . Sit. 9$ 

FORTH BUILDKR is a stand-alone largo compiler (crostcompiler) for 
producing curiam Foilh systems and application programs. 
All of the 83-standard denning words and eonirol structures are 
recognized by FORTHBUUDER. 

FORTHBUILDER is designed to behave as much as possible like a 
resident Forth interpreter/compiler, so that most of the eslablislied 
techniques for writing Forth code can be used without change. 
Like compilert for other languages, FORTHBUILDER can operate in 
"batch mode*. 

The compiler recDgruzex and emulates target names defined by 
CONSTANT or VARIABLE and is readily emended with "compile- 
time" definitions to emulate specific target words. 
FORTHBUILDER is supplied as an executable command file 
configuied for a specific host system and target processor. Object 
cade produced from the accompanying model source code is royalty- 
free to licensed users. 
F.CCF.S- S99.95 

EDITORS & WORD PROCESSING 

JUST from S.E. Media - Text Formatter developed by Ron Anderson; for 
Dot Matrix Pi inters, ptovidet many unique features. Output 
"Formatted* Text to the Display. Use the FPRINT.CMD supplied for 
producing multiple copies of the "Forma tied" Text on the Printer 
INCLUDING IMBEDDED PRINTER COMMANDS (veiy useful at 
other limes alio, and woith Ihe price of the program by uself). "User 
Configurable" for adapting to other Printers (acmes set up for Epson 
MX-80 with Graftrai); up to ten (10) imbeddoj "Printer Control 
Commands". Compensates for a "Double Width" printed line. Includes 
ihe normal line width, margin, indent, paragraph, space, vertical skip 
lines, page length, page numbering, centering, fill, justification, etc. 
Use with PAT or any Cher ediior. 

* Now supplied as a two disk aeu 

Disk*!: JUST2CMD object file, 

WST2TXT PL9 source FLEX. SK'DOS ■ CC 

Disk »2: JUSTSC object and source in C: 

FLEX, SK'DOS. 0S9.CC 

The JTSC and regular JUST C source are two separate programs. JTSC 
compiles lo a version lhai expects TSC Word Processor type 
commands, (.pp ,sp .ce etc) Great for your older text files. The C 



AriUtNllijrLct'naa 
O.OS-f.I -IK'COS 
F . FUX. U . U.OT.IX 
CC* ■ Catar Cnfai. OJ-- 
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source ccmpilci to i standard syntax JUST CMD object tile. Using 
JUST lynlu <4> ,u ,y elc) Wilh all JUST function t ptut several 
additional printer formatting functions. Reference the JUS1SC C 
source. For those wanting in exceikn BUDGET PRICED word 
pronator, will) futures none of the others hive. This is ill 

Ditk II) ■ PL9 FLEX only F. S i CCF . $49.95 
Dak Set (2)F.SA CCF <k 0S9 (C version) ■ $699$ 

OS-9 68K0OO complete wilh Source . $79.95 
PAT from S.E. Media • A full feature screen oiicmcd TEXT EDITOR with 
all the best of "PIE™". For those who swore by and loved only PIE. 
this is for you! All PIE features and mudi morel Too many features to 
list And if you don't like these, change or add your own. PL -9 source 
furnished. "C" source available soon. Easily configured to your CRT. 
with special config section. 

Regular FLEX. SK'DOS $129. SO 

• SPECIAL INTRODUCTION OFFER • $79 95 

SPECIAL PAVJUST COMBO (wtsoxrce) 
FLEX.SK'DOS $99 95 

OS-9 68K Version $22900 

SPECIAL PAT/JUST COMBO 68K $74900 
Note: JUST in "C" nw« avaifobit /or OS-9 
CEDRIC from S.E. Media - A screen oriented TEXT EDITOR wuh 

ivailahiliiy of 'MENU' aid. Macro definitions, configurable permanent 
definable MACROS' - all standard features and the fastest 'global' 
fimcnoni in the west. A simple, automatic terminal config program 
makes this a real 'no hessel' product Only 6K in size, leaving the 
average system over 163 sectors for text buffer - appx. 14.000 plus of 
free memojyl Extra fine for programming it well is text. 

FLEX, SK'DOS $69.95 
BAS-ED1T from S.E. Media - A TSC BASIC or XBASIC semen editor. 
Appended to BASIC or XBASIC. BAS-EDTT is transparent to normil 
BASIC/XBAS1C operation. Allows editing while in BASIC/XBAS1C. 
Supports the following functions: OVERLAY. INSERT and DUP 
LINE. Make editing BASIC/XBASIC programs SIMPLE! A GREAT 
lime and effort saver. Programmers love ill NO more retyping entire 
lines, elc. Complete with over 25 different CRT leiminal configurauon 
overlays. 

FLEX.CCF.SK' DOS $39.95 
SCREDITOR 111 from Wbtdnuh Micro Systems - Powerful Semen- 

Oriented Editor/Word Processor. Almost SO different commands; over 
300 pages of Documentation wilh Tutor ial. Features Mult i Column 
display and editing, "decimal align" columns (AND add them up 
automatically), multiple keystroke macros, evai/odd page headers and 
footers, imbedded printer control codes, all justifications, "help" 
support, store coraroon command laics on disk. etc. Use supplied "set- 
ups". Of remap the keyboard lo your needs. Except for piopoiiional 
printing, this package will DO IT ALLI 
6*00 or 6809 FLEX. SK'DOS or SSB DOS. OS 9 .$17500 
SPELLB "Computer Dictionary" from S.E. Media - OVER 150,000 words! 
Look up a word from wuhin your Editor or Word Processor (with the 
SPHCMD Utility which operates tit tht FLEX. SK'DOS UCS) Or 
check and updite the Text ifter cnliy; ADD WORDS to the Dictionary, 
"Flag" questionable words in the Text, "View a wold in context" before 
changing or ignoring, etc. SPELLB first checks a 'Common Word 
Dictionary", then the nonnal Dictionary, then a "Personal Word List", 
and finally, my "Sprwal Word List" you may have specified. SPELLB 
also allows ihe use of Small Disk Storage systems. 

F. S and CCF - $129.95 



STYLO-GRAPH from Great Plains Computer Co. -- A full-screen oriented 
WORD PROCESSOR - (uses the SI x 24 Display Screens on CoCo 
R.EX/SK'DOS. or PBJ Wordpik). Full screen display and editing; 
supports the Daisy Wheel proportional primers. 
NEW PRICES 6809 CCF and CCO . $99 95. 
F.Sor O $179 95. U $299 95 
STYLO-SPELL from Great Plains Computer Co. - Fail Computer 
Dictionary- Canpkmcms Stylograph. 

NEW PRICES 6809 CCF and CCO - $69.95. 
F.SorO - $99.95. U ■ $149 95 
STYLO-MERGE from Great Plains Computer Co. - Merge Mailing List to 
"Form" Letters. Print multiple Files, etc.. through Stylo. 
NEW PRICES 6809 CCF and CCO - $59 95. 
F.SorO. $79.95. U - $129.95 
STYLO-PAK Graph * Spell + Merge Package DeslHI 
F.SorO. $32995. U $54995 
O, 6SOO0 $695 00 

DATABASE ACCOUNTING 

XDMS from Westchester Applied Business Systems 
FOR 6809 flEX SK*DOS(S/«") 

Up lo 32 groups/fields per record 1 Up lo 12 character file names! Up lo 1024 
byle records! User defined screen ind print control! Process files! Form 
files! Condiiionil execution! Process chaining! Upward/Downward file 
linking! File joining! Random file vinual pagingl Buill in utilities! Built 
in text line editor! Fully session oriented! Enhanced forms! Boldface. 
Double width. Italics and Underline supported! Written in compact 
suuciured assembler! Integrated for FAST execution! 
XDMS-1V Data Management System 

XDMS-IV is a brand new approach lo data management It not only pcnmli 
users lo describe, enter and retrieve data, but also to process enure files 
producing cusuxruzad reports, screen displays and file output. 
Pruces sing can consist of any of a set of standard high level functions 
including record and field selection, sorting and aggregation, lookups in 
other files, special processing of record subsets, custom report 
formatting, touling and subtotaltng, and presentation of up lo three 
reined filet as a "database" on user defined output reports 
POWERFUL COMMANDS! 

XDMS-IV combines the functionality of many popular DBMS software 
systems with a new easy lo use command sei into a single integrated 
package. We've included many new features and commands including a 
set of general file utilities The processing commands are Inpnl-Pfoacts- 
Outpm (IPO) whieh allows almost instant implementation of a process 
design. 

SESSION ORIENTED! 
XDMS-IV is session ooented Enter "XDMS" and you arc in instant 

command of all Ihe features. No more waning for a command lo toad in 
from diskl Many aommands are immediate, such as CREATE (file 
definition). UPDATE (file editor). PURGE and DELETE (uuliiies). 
Oilieri are process commands which are used to create a user process 
which is executed with a RUN command. Either may be entered into a 
"process" file which is executed by an EXECUTE statement Processes 
may execute other processes, or themselves, either condiuonally or 
unconditionally. Menus and screen prompts are easily coded, and entire 
user applications can be run without ever leaving XDMS-IV 
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ITS EASY TO USEI 

XOMS-IV keeps data management simple! Rather than design a complex 
DBMS which hides the true nature of the data, we kept XDMS-IV file 
oriented. The user view of data ndauauhipa n presented in reports and 
town output, while the actual data resides in easy to maintain files. 
This ao^a permits customized premutation and reports without 
complex redefinition of the database Tile* and structure. XDMS-lV may 
be used for a wide range of application s from simple record 
management systems (addresses, inventory ...} to integrated database 
systems (order enuy, accounting ...) 

The possibilities are unlimited 

FOR 6809 FLEX-SK*0OS(S«") $249.95 

UTILITIES 

8adc09 XRef from S.E. Media --This Basic09 Cross Reference Utility is a 
Basic09 Program which will produce a "pretty printed" lifting with each 
une numbered, followed by a complete cross referenced listing of all 
variables, external procedures, and line numbers called. Also includes a 
Ptogram List Utility which outputs a fast "pretty printed" listing with 
line numbers. Requites Baiic09 or RunB 

<4 CCO obj. only - S39 9S. wt Souk* - 179 9 i 

BTrte Routines - Complete set of routines to allow simple implementation 
of keyed files -for your program! - running under Basic09. A real time 
saver and should be a part of every serous programmers tool-box. 
A CCO obj. only. S89 95 

Lucldala PASCAL UTILITIES (Requires Pascal ver 3) 

XREF -- produce a Cross Reference Listing of any text; oriented to Pascal 
Source. 

INCLUDE -- Ioclude other Files in a Source Text, including Binary - 
unlimited nesting. 

PROFILER -- provides an Indented , Numbered, "Struocg ram" of a Pascal 
Source Text File; view the overall structure of large programs, piogram 
inlcgiily. etc. Supplied in Pascal Source Code; requires compilation 
F.S.CCF-EACH S'-UOM. S'SiOM 

DUB from S.E. Madia - A UnlFLEX BASIC decompiler Re Create a 
Souice Listing fioin UniFLEX Compiled bauc Programs. Woiks w/ 
ALL Versions of 6809 UniFLEX basic. 
V ■ S219.9S 

LOW COST PROGRAM KITS from Southeast Media The following luu 
are available for FLEX, SK'DOS on either S" or 8" Disk. 

1. BASIC TOOL-CHEST $29.95 
BUSTER.CMD: pretty printer 
LiNEXREF.BAS: line cross -refcrcnccr 
REMPAC BAS, SPCPAC BAS, COMPAC BAS: 
remove superfluous code 

STRIP.BAS: superfluous line-numbers slnipper 

2. FLEX,SK*DOS imLiTIES KIT $39.99 
CATS. CMC: alphabetically- sorted directs ty listing 
CA1D.CMD-. daietoncd directory listing 
COPYSORTCMD: file copy, alphabetically 
COPYDATECMD: file copy, by date-order 
FILEOATE.CMD-. change file creation date 

INFO CMD(A LMFOGMX.CMD): tells disk anjibuics * contents 
RELINK CMD (A RELINK82): re-oidcrs fiagmented free chain 
RESQ.CMD: undeletes (rwrven) a deleted file 
SECIORS.CMD: show sector order in free chain 
XL.CMD: super text lister 



3. ASSEMBLERS/DISASSEMBLERS UTILITIES $39.95 
LJNEFEED.CMD-. 'modularise' disassembler ouowi 

MA TH.CMD-. decimal , hex. binary, octal «on versions 

& tables 

SKIPCMD: column stripper 

4. WORD - PROCESSOR SUPPORT UTILITIES $49.95 
FULI-STOP.CMD. checks for canalization 
BSTYCrr BAS (.BAC): Stylo to dot-matrix pimter 
NECPRINT.CMD Stylo to dot-murix printer filler code 

5. UTIUTIES FOR INDEXING $49.95 

MENU. BAS: selects requii ad program from list below 

INDEX. BAC: word index 

PHRASES. BAC: phrase index 

CONTENT. BAC: table of contents 

INDXSORT.BAC: fast alphabetic tort routine 

FORMA IbK.BAC: produces a 2-oolumn formatted index 

APPEND.BAC: append any number of files 

CHAR.BTN: line reuter 
BASIC09 TOOLS consist of 21 subroutines for Basic09. 
6 were written in C Language and the remainder in assembly. 
All the routines are compiled down to native machine code which 
makes them fast and aompacL 

1. CFILL - fills a string with characters 

2. DPEEK - Double peek 

3. DPOKE - Double poke 

4. FPOS - Current Tile position 

5. FSIZE - File site 

6. PrRIM - removes leading spaces from a suing 

7. GETPR - returns the current process ID 

8. GETOPr - gets 32 byte option section 

9. CETIJSR - gets the user ID 

10. GTIME - gets the lime 

1 1. INSERT - insert a suing into another 

12. LOWER - convent a suing into lowercase 

13. READY - Checks for available input 

14. SETPRIOR - changes a process priority 

15. SETUSR -- changes ihe user ID 

16. SETOPr - set 32 byte option packet 

17. STTME - sets the lime 

18. SPACE - adds spaces to a string 

19. SWAP - swaps any two variables 
2& SYSCALL - system call 

21. UPPER •- •onverts a string to uppercase 

For OS 9 - $44.95 - Includes Source Code 

Limited Special . $19.95 
SOFTOOLS 

The following programs are included in object form for immediate 
application. PL/9 source code available for cuilomizau'on. 
READ- ME Complete instructions for initial set-up and operation. Can even 

be printed out with Ihe included text processor. 
CONFIG onetime system configuration. 

CHANCE changes words, characters, etc. globally to any texttypc file. 
CLEANTXT converts text files to standard FLEX, SK'DOS files. 
COMMON compare two text tiles and reports differences. 
COMPARE another check file that repons mis-matched lines. 
CONCAT similar to FLEX. SK'DOS append but can also lut files to screen. 
DOCUMENT for PL/9 source files. Veiy useful in examining parameter 

pasting aspects of procedures. 
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ECHO echos to either screen or file. 

FIND in unproved find command' with "pattern" matching and wildcard!. 
Very useful. 

HEX dumpa filet in both hex and ASCII. 

INCLUDE a file copy program (hit will accept "include!" of other disk files. 

KWIC allow! Totaling each word, on each line to the beginning. Very uieful 
in a son program, etc 

LISTDIR a directory lining program. Not super, but better dun CAT. 

MEMSORT a high-speed text file soner. Up to 10 field! may be sonad. 
Very fan. Very useful. 

MULTICOL width of page, number of columns may be specif d. A 
MUST! 

PACE similar to LIST but allows for a page header, page width and depth. 
Adjust for CRT screen or piinter as set up by CONFIG. A veiy smart 
print driver. Allows printer control commands. 

REMOVE a fast Tile deleter. Careful, no prompts iitued. Zap. and its gonel 

SCREEN a screen lining utility. Woid wraps text to fit screen. Screen depth 
may be alteicd at run time. 

SORT a super version of MEMSORT. Ascending/descending order, up to 10 
keys, cue over-ride, son on n* word and tort on characters if file is 
small enough, sons in RAM. If large file, son is conitiained to size of 
your largest disk capacity. 

TPROC a small but nice text forms iter. 1 his is a complete formatter and has 
functions not found in other formauers. 

TRANSLIT sorts a We by x keyficlds. Checks for duplications. Up to 10 
key files may be used. 

UN ROTATE used with KWIC this program reads an input file and unfolds 
it a line at a time. If the Tile has been sorted each word will be 
presented in sequence. 

WC a woid count utility. Can count woids, characters or lines. 

NOTE: this set of utilities constats of 6 S.i/4" disks or 2 8" disks, w/ 
source (PL9). 3 5.174" disks or 1 8" disk w/o source. 
Complete set SPECIAL INTRO PRICE. 
5-1/4" w/ioura FLEX - SK'DOS - S129.95 
w/o source - 579.95 
8* w/tourcc • S79.9S . wfo source $49.93 

FULL SCREEN FORMS DISPLAY from Computer Systems Consultants 
- TSC Extended BASIC program supports any Serial Terminal with 
Cursor Control or Memory-Mapped Video Displays; substantially 
extends the capabilities of the Program Designer by providing a table- 
driven method of describing and using Full Screen Displays. 
F. S and CCF. U ■ 12500. wt Source - iSO.OO 

SOLVE from S.E. Madia - OS-9 Levels I and D only. A Symbolic Object/ 
Logic Verification A Examine debugger Including inline debugging, 
disassemble and assemble. SOLVE IS THE MOST COMPLETE 
DEBUGGER we have seen l"or the 6809 OS-9 seiiesl SOLVE does it 
all! With a rich selection of monitor, assembler, disassembler, 
environments! , execution and other miscellaneous conuruusls . SOLVE 
ii the MOST POWERFUL tool kit item you can own! Yet. SOLVE it 
simple to use! With complete documentation, a snap! Everyone who 
has ordered this package has raved) See review - 68 Micro Journal - 
December 1985. No 'blind' debugging here, full screen displays, rich 
and complete in information presented. Since review in 68 Micro 
Journal, this is our fastest mover! 

Levels I A II only - OS-9 S69.9S 



DISK UTILITIES 

OS-9 VDIsfc from S.E. Madia - For Level I only. Use the Extended 

Memory capability of your SWTPC or Gimix CPU card (or similar 
format DAI ; for FAST Program Compiles. CMD execution, high speed 
inter-process oamsumi cations (without pipe buffers). etc. • SAVE that 
System Memory. Virtual Disk size is variable in 4K increments up to 
960K- Some Assembly Required. 

Level/ OS-9 obj. 179 95, w/ Source 1149.95 

OF from S.E. Media - Written in BASIC09 (with Source), includes: 

REFORMAT, a BASIC09 Program that reformats a chosen amount of 
an OS-9 disk to FLEX, SK*DOS Format so it can be used normally by 
F EX, SK'DOS: and FLEX, a BASIC09 Program that does the actual 
read or write function to the special O-F Transfer Disk: user-friendly 
menu driven. Read the FLEX, SK'DOS Directory, Delete FLEX, 
SK'DOS Files. Copy both directions, etc FLEX. SK'DOS users use 
the special dixk just like my other FLEX. SK'DOS disk 
O- 6909/68000 179.95 

LSORT from S.E. Media - A SORT/MERGE package for OS-9 (Level I A 
only). Sons records with fixed lengths or variable lengths. Allows 
for either ascending or descending sort. Sorting can be done in either 
ASCII sequence or alternate collating sequence. Right, left or no 
justification of data fields available. 1.SORT includes a full set of 
comments and errors messages. 
OS-9 $8500 

HIER from S.E. Media - IIIER is a modern herarchal storage system for 
users under FLEX, SK'DOS It answers the needs of those who have 
hard disk capabilities on their systems, or many files on one disk - any 
size. Using HIER a regular (any) FLEX. SK'DOS disk (8-5 
hard disk) can have sub directories. By this method the problems of 
assigning unique names to files is less burdensome. Different files with 
the exact same name may be on the same disk, as long as they arc in 
different directories. For the Winchester user this becomes a must Sub- 
directories are the modem day solution that all current large systems 
use. Each directory looks to FLEX, SK'DOS like a regular file, 
except they have (he extension ' DIR A full set of directory handling 
programs are included, making the operation of HIER simple and 
straightforward. A special install package is included to install HIER to 
your particular version of F EX, SK'DOS. Some assembly required. 
Install indicates each byte or reference change needed. Typically - 6 
byte changes in source (furnished) and one assembly of HIER is all thai 
is requited. No programming icquired) 
FLEX SK'DOS 179.95 

COPYMULT from S.E. Media - Copy LARGE Disks to several smaller 
dis s. FLEX, SK'DOS utilities allow the backup of ANY size disk to 
any SMALLER si2e diskettes (Hard Disk to floppies. 8* to 5". etc.) by 
simply inserting dis eues as requested by COPYMULT. No fooling 
with directory deletions, etc. COPYMULT.CMD understands normal 
"copy" syntax and keeps up with flics oaned by maintaining directories 
for both host and laccivmg disk system. Alto includes BACKUP.CMD 
to download any site "random" type file: RESTORE CMD to 
restructure aopied "random" files for copying, or recopy [ng back to the 
host system: and FREEL1NK.CMD as a "bonus" utility that "relinks" 
the free chain of floppy or hard disk, eliminating fragmentation. 

Completely documented Assembly Language Source/ties included AH. 4 
Programs (FLEX. SK'DOS. 8~ or 5') S9950 
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COPYCAT from Lubdata - Paital NOT required. Allows reading TSC 
Mini-FLEX. SK'DOS. SSB OOS68, and Digital Research CP/M Disks 
while opeiaiing under SK'DOS . FLEX I O. FLEX 2.O. or FLEX 9.0 
with 6800 or 6809 Systems. COPYCAT will not perform miracles, but. 
between Ihe program and ihe manual, you Hand a good chance of 
accomplishing a Iranifer. Alto includes some Utilities to help oUL 
Piograms supplied in Modular Source Code (Assembly Language) lo 
Itclp solve unusual problems, 

F. Sand CCF 5" $50 00 F. S 8'$65O0 

VIRTUAL TERMINAL from S.E. Media - Allows one terrain*) to do Ihe 
wotk of several. Ine user may sun as many is eight tasks on one 
terminal, under VIRTUAL TERMINAL and switch back and foilh 
between tasks al will. No need lo exit each one; just jump back and 
forth. Complete with configuration program. The best way to keep up 
with those background programs. 

6809 O A CCO ■ obj. only ■ S49.9S 

FLKX, SK*DOS DISK UTILITIES from Computer Systems Consultants - 
Eight (8) different Assembly Language <W Source Code) FLEX. 
SK'OOS Utilities for every FLEX.SK'DOS Users Toolbox: Copy • 
File with CRC Errors; Test Disk for errors; Compare two Disks; a fast 
Disk Backup Piogram; Edit Disk Sectors; linearize Free Chain on the 
Disk; print Disk Identification: and Sort and Replace the Disk Directary 
(in sorted order). -- PLUS-- Ten X BASIC Programs including: A 
BASIC Resequence with EX'IRAs over "RENUM" like check for 
missing label definitions, processes Disk lo Disk instead of in Memoiy. 
etc. Other programs Compare. Merge, or Generate Updates between 
two BASIC Programs, check BASIC Sequence Numbers, compare two 
uniequcncad Tiles, and 5 Piograms for establishing a Master Dirceroiy 
of several Disks, and sorting, selecting, updating, and piinling paginated 
listings of these files. A BASIC Cross Reference Program, written in 
Assembly Language, which provides an X-Ref listing of Ihe Vaiiables 
and Reserved Words in TSC BASIC. XBASIC. and PRECOMPU F,R 
BASIC Piograms. 

ALL. Utilities include Source (either BASIC or Al~ Source Code) 
F. Sand CCF . $50.00 • 
BASIC Utilities ONLY for UniFLEX ■■ $3000 

MS-DOS-FLEX Transfer Utilities to OS-9 For 68XXX and CoCo* OS-9 
Systems Now READ - WRITE - DR - DUMP - EXPLORE FLEX A 
MS-DOS Disk. These Utilities come with a rich set of options allowing 
the transfer of lext type files from/to FLEX A MS-DOS disks. *CoCo 
systems icquire the DP. Johnson SDISK utilities and OS-9 and two 
drives of which one must be a "host" floppy. 

•CoCo Version: $69 95 68XXX Vernon $9995 

MISCELLANEOUS 

TABULA RASA SPREADSHEET from Computer Systems Consultants -■ 
TABULA RASA is similar lo DESKTOP/PLAN : provides use of 
tabular computation schemes used for analysis of business, sales, and 
economic conditions. Menu diiven, extensive report-generation 
capabilities. Requires ISCs Extended BASIC. 

F. S and CCF. U 15000. w/ Source - 1 100 DO 
DYNACALC Elmronic Spread Sheet for Ihe 6809 and 68000. 
F. S. 0S-9 and SPECIAL CCF . $200 .00. U ■ $395 00 
OS9 68K . $595.00 



for maintaining inventories. Keeps item field file in alphabetical order 
for easier inquiry. Locale andAa- pnnt recutii matching partial or 
complete item, deacrtpuon, vendor, or attributes ; futd back order or 
below nock levels. Print-outs in item or vendor order. MRP capability 
for the maintenance and analysis of Hierarchical assemblies of items in 
Ihe inventoiy file. Requires TSCs Extended BASIC. 

F. S and CCF. U - $50110. w/ Source . $100.00 
FULL SCREEN MAILING LIST from Computer Systems Consultant! - 
The Full Semen Mailing list System provides a means of maintaining 
simple mailing lists. Locate all records matching on paitial or complete 
name, city, state, zip. or attributes for listings or Labels, elc. Requires 
TSCs Extended BASIC. 

F . S and CCF. U - SS0M, w/ Source - $10000 
DIET-TRAC Forecaster from S.E. Media - An XBASIC program ihat plans 
a diet in terms of either calories and percentage of caibohydraies, 
pioteins and fats (C P G%) or grams of Carbohydrate. Protein and Fat 
food exchanges of each of the six basic food groups (vegetable, bread, 
meat, skim m. Ik, fnui and fat) for a specific individual. Sex, Age, 
Height, Present Weight. Frame Size. Activity Level and Basal 
Metabolic Rate for normal individual are taken into account. Ideal 
weight and tuslaiiung calories for any weight of ihe above individual 
ire calculated Provides number of days and daily calendar after weight 
goal and calorie plan is determined. 

F.S IS9 95, U-SS9 95 



GAMES 

RAPIER • 6809 diets Program from S.E. Media - Requires FLEX. 

SK'DOS and Displays on Any Type Terminal. Features: Four levels of 
play. Swap side. Point scoring system. Two display boards. Change 
skill level. Solve Checkmate problems in 1-2-3-4 moves. Make move 
and swap sides. Play while or black. This Is one of the strongest 
CHESS programs running on any microcomputer, estimated USCF 
Rating 1600* (belter than most 'club' players al higher levels) 
F. S and CCF - $79 95 

NEW 

MS-DOSIFLEX Transfer UtUiltel For 68XXX and CoCo> OS-9 Systems. 
Now Read, Write, DH, Dump and Explore FLEX A MS DOS Disks. 
Supplied with a rich set of options to explore and transfer text type files 
from/to FLEX and MS-DOS disks. •CoCo OS-9 requires SDISK 
utilities A two floppy drives. 
CCO $69.95 68XXX OS-9 $99.93 



/NOTE: Changes \ 

I Price increase for SCULPTOR, see advertising front of ihis catalog and 
oilier ad in this issue. Special puce for 68 Micio Journal leaders. | 



I 



FULL SCREEN INVENTORY/MRP from Computer Syslans Consultants 
Use ihe Full Screen Inventoiy Syltem/M aleiial t Requirement Planning 



.1 New MS-DOS A FLEX to OS-9 Utilities, see above. 
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"Syntax: COS9 SKFI1£NAME OR OSFUENAME", SOD, $0A 
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ReadySetGo Revisited 



By: James E. Law 
1806 Rock B lu H Road 
Hixson. TN 37343 



Several months ago. I reviewed 
Ready.Set.Go! 3.0 and found It. In spite of some 
minor Irritants, to be an easy-to-use and powerful 
desktop publishing tool. Since then. Revision 4.0 
has been released. This does not change the way 
Ready.Set.Go! works, but contains so many new 
features and enhancements that it must be con- 
sidered a major upgrade. The puipose of this 
aillcle will be to brief ly tell you about the changes 
to Ready.Set.Go! Introduced In Rev. 4. 

Getting Ready 

The first thing you notice when starting 
Ready.Set.Go! 4.0 is that the working window has 
been rearranged by removing the toolbar from the 
left of the screen. These tools have been reposi- 
tioned along the top of the screen or Included In 
various pull down menus. This makes for a 
cleaner working area which Is 13% bigger than the 
Ready.Set.Go! 3.0 window. 

Ready.Set.Go! 4.0 makes It easier to work 
with larger documents. It allows you to set up any 
size document up to 99" by 99." Also, a tiling 
feature is provided for printing ImageWriter and 
LaserWriter copies of very large documents. RSG4 
accomplishes this by dividing the overall Image 
into overlapping 8-1/2" by 11" tiles. You can 
control the amount of the overlap, and registration 
marks are provided for precisely lining up the 
sheets. 

I was glad to note that a grabber tool is 
provided In Ready.Set.Go! 4.0 for moving around 
without having to use the scroll bars. The lack of 
sucha tool In Ready.Set.Go! 3.0 was often a source 
of frustration as I tried to rapidly navigate to the 
desired spot on a large page. 



In Ready.Set.Go! 3.0 the ability to view facing 
pages was helpful In achieving a balanced layout. 
Unfortunately, no editing could be done while In 
thlsvlewlngmode. In Ready.Set.Go! 4.0. however, 
the facing pages view Is interactive. This makes It 
easy to design and adjust graphics which stretch 
across both pages. 

Adjusting the Fine Print 

One of the things that Impressed me most 
about Ready.Set.Go! 3.0 was the extensive control 
provided over the aestheticsof text. Ready .Set .Go! 
4.0. however. Increases this control significantly. 
For example, Ready.Set.Go! 3.0 allowed great 
flexibility In setting letter, line, and paragraph 
spacing. In addition to those parameters. 
Ready.Set.Go! 4.0 allows you to control the spac- 
ing between words. The handling of tabs In 
Ready.Set.Go! 3.0 was a source of confusion and 
complaints. This feature has been revised In 
Ready.Set.Go! 4.0 to make it simpler and more 
intuitive. 

In addition to all the normal text styles (e.g.. 
plain, bold, outline, etc.). Ready.Set.Go! 4.0 
makes available condensed and expanded text, 
over-struck text, and reversed type. 

If you are a "detail" person, you'll love the 
ability to set hyphenation specifications in 
Ready.Set.Go! 4.0 You can set the minimum size 
word to be hyphenated, the minimum number of 
characters before and alter the hyphen, and the 
maximum number of consecutive hyphens that 
may occur. You can also indicate whether the last 
word In a paragraph or capitalized words can be 
hyphenated. 
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With all the flexibility provided by this pro- 
gram to specify In detail the attributes of text, 
creation of document with unclear or unattractive 
typography will definitely not be Ready. Set.Go! 
4.0's fault. 

It's Got Style 

Ready.Set.Go! 4.0 allows users to save time 
on repetitive setups by preparing style sheets. For 
example, separate style sheets might be set up for 
the body of a document, for minor headings, and 
for major headings. Macros can be set up which 
enable a style sheet to be called by holding down 
the COMMAND key and typing "H" then the as- 
signed character. Style sheets cover font type, 
style, and size; left, right, centered, or justified 
text; tab settings; indents; word. line, and para- 
graph spacing, and whether hyphenation is on or 
off. Style sheets can be saved, imported, dupli- 
cated, modified, or deleted. 

Another way of making universal changes to 
font type, style, or size Is to use the search and 
replace function. You could, for example, auto- 
matically change all underlined words to bold text. 
Similarly, all Geneva 12 text could be automatic 
callychanged to Bookman 10. This function could 
be of great help to those making last minute 
format changes to large documents. 

Handling Graphics 

Ready.Set.Go! 4.0 imports graphics in TIFF 
and EPS format in addition to the PICT and 
bitmapped formats handled by Ready.Set.Go! 
3.0. Also, it provides greatly Increased flexibility in 
managing the visual relationship between text 
and adjacent text. When graphics is placed within 
a text block, "run around* can be turned off in 
which case the text flows right over the fft-aphlcs. 
Alternately, the graphics block (an invisible rec- 
tangle around the graphics) may be set to repel the 
text. A new option presented by Revision 4 Is to 
have the text repelled only by the graphic object. 
In this case, the text neatly follows the outline of 
an irregular shaped graphic. This can be used to 
create some really striking layouts! The distance 
the text Is repelled by the graphics or the graphic 
block Is adjustable. 



But what About theManual 

If you read reviews about Ready.Set.Go! 3.0. 
you know that no one liked the manual. It was a 
skimpy publication which was more like a maga- 
zine than a users manual. The Ready.Set.Go! 4.0 
package largely Axes this problem by including a 
218-page manual along with a veiy helpful book 
on layout. The users manual seems complete and 
clearly written. 

Fine Tuning 

Ready.Set.Go! 4.0 has some compatibility 
problems with the printer driver included with the 
Apple MultlFlnder. This occurred because tight 
schedule forced Letraset to test Ready.Set.Go! 4.0 
against a prerelease version of the MuliFlnder 
package. Apple then changed the coding of the 
printer driver before final release. A maintenance 
revision 4.0a has been prepared to solve this 
problem and is scheduled to be shipped free to all 
registered owners in late Feburaiy. 

I reviewed a beta copy of Ready.Set.Go! 4.0a 
and verified that it is completely compatable with 
the MultlFlnder printer driver. Additionally . it 
includes the following enhancements: 

1 . The readlbillty of text in the 200% view has 
been improved. 

2. Double clicking any text block, graphics 
block, or graphics element brings up the 
related specification block. 

3. Ready.Set.Go! 4.0 supports additional 
versions of TIFF. 

4. The highly compact RIFF files created by 
Letraset' s new photo retouching pro- 
gram called ImageStudio can be read 
directly. 

In Conclusion. . . 

With Ready.Set.Go! 4.0. Letraset clearly 
demonstrates their commitment to being taken 
seriously in the Macintosh desktop publishing 
nitch. This is a powerful product that will well 
serve the needs of most users. The "big name" 
competition had better keep on their toes or 
Ready.Set.Go! will leave them behind. 
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By-. K. Jones 

Micromcs Research Coip, 

33383 Lyim Ave.. Abbouford. B.C. 

Cnuda V2S IE2 

Copyiigbied O by R. Jones & CPI 



SOLUTION TO TEST NINE 

l£('s talk our way ihrough this one lo show how the flow-table is developed. First, we'll let the outputs Z I. Tl and T2 
represent the alarm, a 2-minute timer and a 3-minuie timer respectively. 
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As usual, we'll commence at address 0000.1 with a stable all-zero output-slate. Operation of XI moves us to address 
1000.2 (with all outputs held at 0), and its subsequent telease slides us to 0000.2, at which Lime we'll energise both Tl and 
T2. In this location we're now wailing lo sec whether Tl's liming-out or X2 will occur first. We'll assume that X2 opeiales, 
which moves us to address 0100.3 with the alarm Zl operated. On the elbow, 0100.2, we'll make Zl a phi AND DE- 
ENERGISE BOTH Tl AND T2. It's important at least to de-energise Tl. in case il should lime out while we're moving 
vertically downwards to 0100.3 and ihus enter into a critical lace with this movement as il tries to slide us horizontally into a 
new column. We're now in a stable stale wiih ihe alarm ON. 



On ihe other hand, Tl may time out first (2-minules elapsed), in which case we'll move from 0000.2 to 0010.2. where 
we'll sit in a stable stale, wailing to sec whether T2's timing-out or X2 will occur first. Again let's assume lhal X2 occurs 
first, sliding us first to 01 10.2, where we'll de-energise T2 in case il should choose to time out at this critical moment, and 
then venically to 01 10.1. Here's where we'll de-energise T I, rather than diieclly in 01 10.2, to avoid a critical race between 
the dropping-oul of T I's contact and the relay moving us vertically. The de energising of T 1, of course, moves us sideways 
to address OlOO.l, with all Zs OFF. 

Back to address 00 10.2 again, lo consider the possibility of T2's liming-oul first. This would slide us sideways to 
address 00 1 1 .2, where we'll wail indefinitely for X2 to arrive and send us lo address 0111.3, thus activating the alarm. 

Only one merger is possible - lhal of rows 2 and 3, lo give us a 2-row merged flow-table. As this requires only one relay 
for its implementation, we'll code row 1 with a ted and row 2 with a red 1, and allocate the values 16, 8, 4 and 2 to XI, X2, 
Tl and T2. 

All Box-Bs are then completed, and an intermediate decoding-table prepared, after which it only remains lo cany out the 
actual decoding and draw the circuit diagram from the Boolean expressions. It would piobably be a good idea for you to try 
the decodings with the card-decoder to be described next, and check off your results against the tables you produced manu- 
ally. 
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In case you've forgotten, here's how we figure out the minieim numbers for Y 1, where rows 1 and 2 correspond to a 2- 
unit stale-diagram. Note that lo Ihe left of the flow-table there's a red 1 in row 2. The red 1, which symbolises Y I's ener- 
gisation, indicates thai Y 1 will be energised wherever there's a black 2 (because we're looking at row 2) in Ihe flow-iable 
itself. So we go through the table looking for black 2s, and when we find one we note Ihe corresponding red minterm- 
number in Box-B and put a 1 for Yl under this minierm-number in ihe intermediate table. Got it? OK, now we'll proceed 
with actual decoding. 

Notice that in the decoding for Yl we've creaicd an auxiliary decoding row because we were blocked by yl in row 2. 
However, our original iow (ie 2) allows a factoring of yl with row 1 , so we'll slick with row 2 as ihe auxiliary row allows no 
factoring. 

Ihe final Boolean expressions are therefore : 

Y 1 = Tl'.y 1 + X2'.y 1 + T2 + XI = X 1 + T2 + ylCIT + X2') 
Zl = X2.Tr.yl-t- X2.T2 = X2(Tl'.yl +T2) 
Tl *Xl'.X2'.yl + Tl.yl = yl(Xl'.X2' + Tl) 
T2 = Xl.X2'.yl+T2 

There are other way s to implement the specs, of course, such as making T2 a 1-minute timer. Wilh this approach, only 
Tl would be energised at address 0000.2. and 11 activated when Tl limes out. 

Mile 1 1 - heading for Mile 12 
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BEFORE WE PROCEED 

In all our worked examples, you'll note (hat I've taken through to completion only the one approach to a problem. In 
norma) practice, I'd scan for "hazards" (re-read an earlier lesson for an explanation) and/or try decoding the Os and phis (and 
then complementing the expressions) to see if there's a belter circuit. However, if I did this with each and every example I 
present to you, we'd get slowed down too much, so I'll leave that pan up to you! Now for 

CARD-DECODING OF DECIMAL MINTERMS 

You'll find, when you become involved in designing more complex circuits, that as the number of variables increases, 
and also the number of Ys and Zs to be decoded, the task of decoding the mintenn-numbers becomes quite heavy, and the 
possibility of error becomes greater too. This means that all your calculations will have to be checked, as it's much better to 
find an error at this stage than to build your machine, and then find that it doesn't behave the way it should because of some 
small(?) slip in the decoding. 

I can stale from painful experience, too. that there's nothing more frustrating than, let us say, trying to eliminate the ninth 
variable in a ten or eleven variable decoding, to find that '2' will "go with" 127 of the minteim-numbersonly to end up being 
blocked on the 128th. We're faced, in decodings of this magnitude, with the honible choice of checking through first to sec 
if this particular variable CAN be conveited to phi, and if so to repeat all our calculations a second time insening, say, 2s 
under ihe minierms, OR putting the 2s in as we go along and then having to go back and erase them all should we get blocked 
somewhere along the way. Either way, it's not an easy task! 

There just HAD io be a better way than this, so several years ago. when I was involved in decoding more than thiity Ys 
and Zs in ten variables (with each device's decoding producing about 12 rows and taking approximately two-and-a-half hours 
to carry out), I designed a set of punched cards which reduced the decoding lime for each output to about 3 or 4 minutes. 
Further, when I checked over the expressions I'd already decoded I was amazed at the number of eirors which had crept in. 
In some cases I found that I'd gone to the trouble of writing 2 under maybe 128 minteims, only (in my joy at finding that it 
"went") to forget tochange the variable concerned into a phi. All that work absolutely wasted!!**??!! 

Since then I've constructed a smaller 6 -variable decoder which is extremely compact, made from thin sheets of clear 
acetate, with strips of black masking-tape (or draughting-tapc) to mask out the cross-hatched bars indicated in the drawings of 
Diagram 48. My original 10-variable set was made of sheets of opaque plastic and the clear portions (corresponding to those 
in the 2" x 2" central square of my later set) were reamed out instead. 

Anyway, there are six cards altogether (one for each variable) as shown in Diagram 48a through 48f, plus a backing 
matrix of minterm-numbers shown in 48g. 
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All cards arc 2 inches by 3 inches, and all masking strips arc 2 inches long. You'll notice that the width of the space 
between the strips is the same as that of the strip itself for all cards. The cards arc airangcd so that when the figure '0* 
arrears at the lop of the card, thcie's a clear strip down the left-hand side (or along the top) of the centre 2x2 square. If the 
card is rotated so that a ' V appears at the top, the opposiic is tiuc. that is, a dark strip is now down the left-hand side or along 
the top. Note too that these digits and 1 move inwards by 1/4 inch as we progress through the scries of cards (a) ihrough 
(0- ALL DIAGRAMS ARE DRAWN TO SCALE. 

The cards should be made from a material ihin enough and clear enough to sec reasonably ihrough six layers, but thick 
enough to rciain a ceilain amount of rigidity. 

Having made these six cards, ihc final step is to draw 48g on a piece of paper or thin card, and over it to paste a clear 

sheet of 2 x 3 acetate. 

i 

GETTING THE FEEL OF THE CARDS 

Now, to begin with, let's stack the cards together with ihc 1-card on the bottom and the 32-card on the top, and with all 
0s at the top of the cards. Along the top of the cards you should now read the binary number 000000, and to our great 
surprise, if this stack is placed oo top of the backing-mairix, what do we sec ihrough the single clear 1/4 x 1/4 window in the 
central 2x2 section? Why, the decimal equivalent of this number, that is 0. Let's rotate some of the cards, so that at the top 
we sec different binary numbers, let's say 101 101 , and place them on top of the matrix. Again we sec the decimal equivalent, 
namely 45. Try a few more for yourself, and then we'll Icam how to use them to perform the decoding operation for us. 

USING THE CARDS TO DECODE A SET OK M1NTERMS 

Well, I think we're now ready to try a simple decoding, so for a trial run let's do Press Zl's decoding of Diagram 47b. 
Just as before, we draw up the framework of the dccoding-tablc, and we're set to go, but first, as there are only four variables 
involved, we'll put to one side the top two cards, namely the 32-card and the 16-caid. 

We insert our usual V under mintcnn-l and write 0001 to the right, which is the number to which we must set up our 
four remaining cards. Having done so, our next step is to lake the matrix-card and (with a felt-tip pin or a pencil capable of 
writing on plastic) we put a bright red V or medium-sized dot over each decimal number corresponding to an UNDESIRED 
mimenn in ihc intermediate decoding table forZl, ieO, 2, 3, 7, 10, 11 and IS. These conespond toOs. Note ihat we do NOT 
mark phis. 

Now, if we place the cards over the matrix, we should see the number 1 through the window. So ... holding the cards and 
the matrix in a neatly stacked pile, we remove the top 8-card and look at the additional window which has been created. We 
see here the figure 9 (compare with the original decoding table in Diagram 47b), because 1 + 8 = 9 is available. We thcieforc 
place the 8-card lo one side, and remove the 4-card. Two more numbers pop into view, namely S and 13, so the 4-card can be 
discarded. Of course, the Sand 13 correspond to adding 4 to each of our already existing minienns 1 and 9. 

Proceeding, we remove the 2-card and what is this? We see a lot of red 'x's through the additional windows thus 
created. This means ihat we can't discard this card, so we re-insert it in the pack IMMEDIATELY ABOVE THE MATRIX 
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CARD. This would also be done even if only one red V were visible, as we find to be the case when we tiy removing the I- 
card from the pack. 

And so we're left with two cards, whose binaiy headings, and 1, occur over the bit-positions 2 and I at the top of the 
matrix. We therefore convert to phis inourdecoding-table the variables occurring in bit-posilions 8 and 4 (corresponding to 
our discarded cards), and place a tick under Ihose minierms whose numbers are visible through the windows in our decoding 
cards. 

That's one decoding row done, so let's carry on with row 2 and at the same time polish up our procedure slightly. 
Beginning with an V under minterm-4 (the next minterm not already covered) and writing 0100 to the light, we now set up 
our four cards to read 0100, and place them on top of the matrix, verifying that 4 does in fact show through the single 
window opened up. Removing the 8-card does not show red. so we discard it On removing the 4-card we do see red, but 
before re-inserting it ON TOP OF THE MATRIX we'll check to see whether one of ihe red "x's is due to the base-minieim 4 
itself. This is done by noting that we're trying to discard the 4-card, currently showing 1 at the top, ie, we're hying lo 
SUBTRACT 4 FROM THE BASE 4. As 4 -4=0, and we see a red through one of the windows, it means that we can't 
even begin a run, so we re-insert the card. On the other hand, if iheO seen through the windows were NOT red, it would 
indicate that we could start a run, but would get blocked along the way by one of the other red (forbidden) numbers. 

When we lift the 2-card no red shows, which means, of course, that we can discard it, but when we remove the 1-card we 
see red again, NOT DUE TO THE BASE-MINTERM. as our check shows that 4 + 1 = 5 is a clear number. Don 't forget, we 
ADD I to the base here because we're irying to convert an existing card into a phi, which can only be done by superimpos- 
ing a 1 over the 0. In this instance, as we started a run (because 5 is clear) we put our usual tick to the right of the row to 
indicate a non-essential prime-implicant, and a dot over the I -variable to indicate a block at this point. Again we find 
ourselves left with two cards, ihe 4-card and the 1-card, and we therefore convert the discarded variables in row 2 to phis, and 
puta tick under minterm-12. With the automatic decoder we don't bother to record the phi-minterms to the right of the table 
as we do wiih manual decoding. 

As we were blocked by Ihe 1 -variable in row 2, we'll create an auxiliary decoding iow commencing once more on 
minierm-4, and stack up Ihe four cards just as before. Bui this lime we'll remove Ihe 1-card FIRST, and then proceed 
systematically from the top of llie slack downwards, lo end up with ihe 4-card and Ihe 2-card. Then we convert to phis the 
discarded 1 and 8 variables, and place licks under minierms S. 12 and 13. Along the way, we'll have placed a tick to the right 
of the row to indicate a non-essential prime-implicani the moment we found ourselves blocked by ihe 2 -variable, and also pul 
a dot over this variable in row 3. 

Before doing another device's decoding it goes without saying that we commence by wiping out our matrix, and marking 
red 'x's for the new set of forbidden (or 0) slates. 

Also, if we're going to do a 0-decoding in order lo eliminate a hazard or merely lo see if it produces a "belter" decoding, 
Ihe Is become forbidden, and we mark them in red instead. As we mentioned earlier, phis can be read as either or I , so 
they're left clear for eiiher type of decoding. Don'l forget this!!! PHIS ARE NEVER FORBIDDEN! We can use Ihem as 0s 
OR Is. 

CONVERTING PRIME IMPLICANTS TO DECIMAL MINTERMS 

To date we've done quite a bil of extracting prime-implicanis from minierms, bul suppose we were asked to do Ihe 
reverse? Thai is, suppose we were asked to state what minterm -numbers are covered by e'e, given that this is part of a 5- 
variable machine using controls a, b. c, d and e. 

With our decoding cards it's an easy job! We simply stack the 4-card on top of Ihe 1-card so they read— 0-1, PLUS 
THE 32-CARD SET TO 0. as Ihis is Ihe ONLY UNUSED variable. We Iherefore have a combined leading of 0—0- 1 at Ihe 
lop of our cards, after which we read off all exposed numbers. If we were interested in, say, 'be' in a 4-variable machine, 
we'd discard 'a' and d" (lhai is the 8-card and the I <ard) BUT RETAIN THE TWO HIGHEST CARDS SET TO 0. Thai is. 
ihe 32-cardand the 16 card, after selling ihe 4-card and Ihe 2-card lo 11, lo give a reading of 00-1 1, and again read off all 
exposed decimal numbers. 

Manually, it's not much more difficult if only a small number of variables is involved. In the case of our first example, 
e'e, we'd begin by writing — 0-1 to represent e'e in a 5- variable setting, and imagine that each'-' is a '0'. This gives us our 
first minteim-number, 1. Now, WORKING FROM THE RIGHT, we'll convert these '-'s, one at a time, to M's, adding ihe 
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value of that particular bit-position to all decimal numbers obtained so far. 

Thus our first '•' is in bit-position 2. so we add 2 to our 1 to give us a sequence of 1. 3 so far. Next we'll convert bit- 
position 8, which means adding 8 to our sequence, to give us 1 , 3. 9 and 1 1 up to this point. Finally, we have to add 16 to 
each of these, to give a resultant mintenn coverage of 1, 3. 9, 1 1, 17, 19, 25 and 27. 

If you work from the light, as we did here, you'll find that the mintenns will be developed in strict numerical order. 

For the moment we'll take a break from sequential circuits, just to let it all sink in, but we'll come back to them a little 
further down the road. On the next leg of our Journey we'll examine certain special types of combinational networks, and 
learn some rather strange and wonderful ways of achieving very sophisticated relay networks, many of which would be 
viitually IMPOSSIBLE to develop by any other means. 

In lieu of a test, I'll give you a chance to go back over some of your earlier manual decodings and try them again with 
our decoding-cards. Maybe some of you will even want to extend them to, say, eight variables, but keep in mind that each 
time you add a variable, one of the central square's dimensions will double, so that for eight variables (and keeping the centre 
as a square) you'll have cards of dimension 4" x 5". You'll also find that extra layers of acetate begin to act like a mirror, so 
you'll have difficulty seeing through to the matrix below. In which case your best bet would be to begin with opaque cards 
and cut out the clear portions of the central square. In addition, you'll also have to cut pieces off the lop and bottom edges of 
the cards so the Os and Is now stick up like little "cars" or index-tabs. You may find that you'll also have to go for larger 
than 1/4 x 1/4 windows in order to accommodate the much bigger minterm-numbcrs you'll have to write on the matrix-card. 

Of course, it'd be a lot nicer if one of you wrote a program to handle this! Don't forget that when 1 was heavily engaged 
in all this stuff (going back to the late SOs and early 60s), no computer service was available at all, which is why I worked on 
developing these cards. But they sure paid off, and enabled me to design some very complex control systems in much less 
time than by my former manual method, AND MORE ACCURATELY TOO! 

...End of Mile 1 1 

+++ 
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This monlh we start our discussion of Modula-2, by way of 
comparison with OmegaSofl Pascal and C. 

When it comes to structured languages, the two most 
important seem to be Pascal and C. Pascal came out about 1970 
and was originally intended as a tool to leach students structured 
programming. It has since become a very popular language all over 
the world, with many different varieties to handle different 
applications. The C language saw ihe light of day around 1977 and 
was primarily intended to be a fairly low level language for 
operating systems programming. It loo has expanded it's applica- 
tions into many areas of computer science. 

Both languages are well suited to projects requiring one or a 
few programmers. Large projects that require dozens of program- 
mers sometimes fall prey to a problem of coordination between 
programmers using either language, litis is aggravated by the lack 
of inter-module reference checking during compilation. Both C 
and Pascal allow references between modules, both procedures and 
variables can be declared in one module, and referenced in others, 
lite problem lies in the lack of type checking between modules. In 
OmegaSofl Pascal, this type checking can be done in the debugger, 
but can only check those modules that are compiled with debug- 
ging information enabled. Some C packages include a separate 
"lint" program that does this same function, but this is lacking 
from all too many C packages. 

In 1980 the creator of Pascal, Niklaus W'uth. published a 
specification for a new language, called Modula-2, that deals 
effectively with this problem. Modula-2 borrows much of it's 
syntax from Pascal, but adds the concept of "Definition" and 
"Implementation" modules, lite definition module declares 
external definitions for the module, the Implementation module 
has the actual code to implement the procedures. With this method, 
the "Definition" module is provided to the other members of ihe 
programming group, and they work with this definition module. 
The implementation part of the module is known only to the 
programmer actually responsible for the module, and is free to 
make improvements without affecting those who reference his 
module. 

The definition module has other advantages. First, it is used 
by the compiler when a programmer needs to reference procedures, 
types, or variables in the module. The programmer does not need 
to declare parameters, constant values, or anything other than the 
name of the item he needs to use. tlte compiler derives this 
information from the definition module. This can eliminate many 
potential errors in parameter passing for instance. Second, if 
properly commented, it provides system-wide documentation for 
the interface between modules. Third, it allows for so called 



"opaque" type declarations. Opaque types can be used so that other 
programmers do not know the structure of the type, they can only 
use the procedures that operate on that type, litis can eliminate the 
costly problem of having everyone know the structure of a 
complex data type, having some programmers operate on individ- 
ual fields of the structure, and having the programmer who has re- 
sponsibility for that type change it's structure, creating difficult to 
find errors. Opaque types avoid this problem by excluding other 
programmers from doing anything other than what is intended to 
be done with the type. 

In a sense, Modula-2 can be considered to be a replacement 
for both Pascal and C. Since OmegaSofl Pascal is an extended 
version of standard Pascal, and we wouldn't put out a Modula-2 
compiler that was less capable than what we already have, 
OmegaSofl Modula-2K will be an extended version of Modula-2. 
Wirlh's Modula-2 still comes from a University environment as 
does standard Pascal and in some areas does not take into account 
that many Microprwessor programmers are in fact. Electronic 
Engineers. Chemical Engineers, or anything but computer science 
trained, and have a different perspective of programming prob- 
lems. 

Note that OmegaSofl Modula-2K is not yet available. When 
will it be available? sometime in 1988 (that's the best I can do for 
an estimate right now). All references to Pascal are assumed to be 
OmegaSofl 68020 Pascal, unless it is noted to be standard Pascal. 
All references to Modula-2K are for OmegaSofl Modula-2fC. 
Wirth's original Modula-2 is simply referred io as Modula-2. All 
references to C are for C as defined by Kcmighan and Ritchie. 

There are some basics lhal mosl languages have in common, 
ihese are : 

1) Data types and constants 

2) Variable allocation 

3) Operators 

4) Built-in procedures 

5) Statements 

6) Inter-module references 

Lets start at the top of the list, data types. Since OmegaSofl 
products are targeted at real-time applications, it is important to 
make sure that data types can be efficiently implemented on the 
Microprocessor family being used (in this case the 68000 series). 

One of the most basic data types is simple on/off data. Since 
this type of data only has two states, it can be represented in 1 bil. 
The 68000 doesn't allow memory accesses of one bit, so it is 
commonly implemented as the least significant bit of a byte, 
therefore it has two possible states : 
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Bit I 76543210 
ON 000O0001 



Bit I 76543210 
OFF 00000000 



In Pascal and Modula-2K this data type is called boolean. C 
has no such dala type, and suffers accordingly. Boolean types have 
two slates, called tnie and false and are commonly used as flags, or 
as the result of comparisons. 

The next simple data type normally encountered is used to 
handle ASCII characters and is called "char" in Pascal. Modula- 
2K. and C. It is stored in one byte of storage on the 68000 series. 
The ASCC character set only defines 128 values, the other 128 
values are often used lo handle extended character sets, or may be 
invalid depending on the operating system environment. 

The most used group of types are called "integers" and are 
signed values using two's complement arithmetic. The 68000 
series supports three fixed point data sizes, and so there are 
normally three variations : 



Pascal Modula-2K 

8 bit short integer short lnt 

16 bit integer integer 

32 bit long integer langlnt 



not supported 
short and/or int 
int aiid/or long 



Integets are commonly used for counters, numeric values, and 
many other uses. Note that C compilers tend lobe split on what 
size an integer is, some of them are 16 bit, others are 32 bit. Those 
that use 32 bit will tend to be slower than those thai use 16 bit but 
possibly more compatible with UNIX C programs. 

Standard integers ue probably the most commonly used and 
are the most efficient size for the 68000 series, litis is especially 
Due on the 68000 with it's 16 bit data bus and more limited ALU, 
almost any insnuclion dealing with data will lake longer if il is 32 
bit than 16 bit. On Ihe 68020 there is less of a speed difference 
(assuming 32 bit dala is aligned on longword boundaiies in 
memoiy), but even so. 32 bit operations lend lo take longer than 1 6 
bit. 

Short integers (8 bit) are most likely lo be used lo correctly 
interface with hardware, such as an 8 bit signed A/D convenor. 
This allows il to be accessed correctly as 8 bits, but still allows 
operations on il to be mixed with larger signed dala sizes. Another 
use for 8 bil integers are if you had a large array of integer values 
that are within the range of 8 bits, using shordntegers would lake 
half of the space in memoiy to store ihe array. 8 Bit operations run 
at Ihe same speed as 16 bil operations, except if you are templed to 
use 8 bil integers as array indexes. This is because the 68000 series 
does not have an 8 bil index mode, only 16 and 32 bit. In this 
situation it has to extend the 8 bil value lo 16 bits, thereby 
generating extra code and wasting time. 

Long integers (32 bil) are used where the range of a 16 bil is 
exceeded. 32 bil operations usually run slower than 16 bil 
operations, so only use this type when necessaiy. The Pascal and 
Modula-2K compilers allocate global longimegers on longword 
boundaries when compiling for a 68020. so that Ihey can be 
accessed in one memory reference. 



Sometimes you don'l want lo be using signed arithmetic, for 
instance, dealing with an unsigned A/D convertor, or when 
accessing memory. In this case, there is an unsigned version of the 
integers : 



Pascal 

8 bit shorthex 

16 bit hex 

32 bit longhex 



Modula-2K 

shortcard 
cardinal 
long card 



not supported 

unsigned short and/or int 

unsigned int and/or long 



Another reason to use unsigned values, is that in Pascal 
unsigned values are printed in hexadecimal formal, while integers 
are printed in decimal format. 

Although nol always needed in real-time applications, lloating 
point values are very useful lo have available, especially in 
scientific programming. 





Pascal 


Modula-2K 


C ttyp 


32 bit 


real 


real 


float 


64 bit 


longreal 


longreal 


double 



Both Pascal and Moduli 2K use the IEEE formal and support 
the 68881 and 68882 coprocessors, many C compilers will also. 

Another data rype that is useful, but nol completely necessary 
is the enumerated type found in Pascal and Modula-2K. and found 
as an extension in some C compilers. This data type allows you to 
specify the valid names for a value, such as : 

colors - (red, blue, green) ; 

In essence, what you have is similar to having three shoilhex 
constants, being defined as red = 0. blue = I, and green = 2. These 
values are stored in one byte, so have a maximum of 236 possible 
values. In Pascal and Modula-2K the starting value can be declared 
using something like : 

extendedascii - (:127, square, circle, upline, 

aeroaaline .... 



Ihe value after the' 
will have a value of 128. 



1 specifies the last value used, so square 



In Pascal and Modula-2K you can define a subrange of many 
of ihe non floating point data types. These are normally used for 
array declarations and such, for instance : 

slotvalue - array [-10 . . 101 of real ; 

-10 .. 10 is a subrange of integers that lets the compiler know 
that the valid range for indexing this array is from -10 to 10 
inclusive, and tells il thai this types needs room for 21 real 
elements. Modula-2K has a slightly different syntax for subranges. 
In the above declaration, the brackets are part of the subrange 
definition, and nol Ihe array definition. C does nol have Ihis 
facility, so lhal all arrays start at zero and all ref erences lo such an 
array in this example would have to have ihe value 10 added 
before doing the array access. 
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Beyond the simple types, we get into the structured types. The 
most basic structured type is the array, and is available in all three 
languages. In Pascal arrays are declared using : 

ARRAY I < Index-type* ] OF <type> 
In ModuU-2K : 

ARRAY <lndex-type> OF <type> 
InC: 

<type> <variable-name> I <highest-index> ] 
In all three languages arrays are accessed the same way : 

<vari able-name > [ < index- value> J 

. Ariays store multiples of the same data type. 

A variation of the array is the string. The string is normally 
used to store a sequence of ASCII characters, but in Pascal can be 
used for other data as well, regardless of it's value. In Pascal a 
siring is defined as : 

string - 80 characters max 

string [<limit>] - specified maximum size 
maximum) 

In addition, the string can be indexed by a character or integer 
value from up to the maximum declared limit. Element zero of 
the string is the number of characters that are currently valid in a 
string, for instance : 

var 

s : string 1 10] I 
begin 

s :- 'hello' ; 

s[0J - S (the number of valid characters) 
s[l) - 'h' s(2) - 'e' .si31 - '1* 
sM) - '!• s[51 - 'o' 

elements 6 through tO contain garbage data. 

In Modula-2K and C. strings are simply arrays, so for a 10 
character siring : 

Hodula-ZK ; s : array [0 .. 9) of char 
C : char sIlO] 

In both languages the end of the string is marked with a zero 
byte, so for instance, in Modula-2K : 

s :- 'test' ; 

s (01 - «t' all] - 'e' s[2] - 's' 
s[3) - »f s(4) - 

elements 5 through 9 contain garbage data. 

Which one is better? actually neither. The pascal method 
allows any value to be represented in the siring since it does not 
use a tetininator. For instance, this is used in the assembler and 
linker to hold relocatable object records. It is also vety easy to 
del0Ttiine the length of a Pascal string. On the other hand, the 



Pascal method limits the size of the string to 2 S3 characters 
maximum. 

The Modula-2K and C methods allow for a siring of any 
length, up to the limit of memory. On the other hand, you cannot 
use the value tero in your siring, which limits it's uses, and to 
determine the length of a string you have to scan the entire suing 
until you find a zero. One advantage the Modula-2K and C 
methods do share is that many operating system use the same 
format for file names, so there is no conversion needed as is 
sometimes required with Pascal strings. 

Another more sophisticated data type is the structure, called a 
"record" in Pascal and Modula-2K. and a "struct" in C. This data 
type allows you to put together other data types into a single entity 



PASCAL AND MOWJLA-2K 



record 

name : string ; 
age : integer ; 
balance .- long real 

end ; 



struct customer ( 

char name 180] ; 
int age ; 
double balance 

) ; 



For all three languages, an individual element of a structure is 
accessed by using the structure name, a period, and then the field 
name, such as : 



customer .aoe 



31 



customer .age 



31 



The SET data type is supported by both Pascal and Modula- 
2K. but is not available in C. Sets are a mathematical abstraction 
for a collection of objects. For instance, consider the ability to 
generate 8 colors (black, white, the three primary colon, and 3 
mixtures of the primary colors). In Pascal you would define the 
three primary colors as : 

type 

colors ■ (red, green, blue) ; 

And ihe collection of Iheic colors at : 



primaries : set of colors ; 

The type primaries then can contain any combination of 
colors, the empty set {nothing in it) in this case would represent 
black, all colors in Ihe set would be while (assuming we are talking 
about mixing light here, and not pigments). 

primaries :• |) ; (■ black •) 

primaries :- (red, green, blue] ; (• white •( 

primaries ;- [red) ; (• red ■) 

primaries :- [green, blue] ; (• yellow ■) 

The syntax and capabilities in Pascal and Modula-2K are 
different, even though the concept is ihe same. The above 
examples were in Pascal. The declarations are the same in both, 
bin the syntax for a set constant is different, in Modula-2K white 
would be : 

primaries •-■ (red. green, blue) ; (' white ") 
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ModuU.2K uses curly braces instead of brackets for set 
constants. Pascal uses a dynamic length set structure very similar 
to a siting where the first byte is the current length of the set. The 
most significant bit of the next byte is the highest set element, 
down to the least significant bit of the last byte, which is element 
zero. The internal representation in Pascal for yellow is : 

SET LENGTH tl) BITMAP 

76543210 76543210 



00000001 
B G R <- COLORS 



110 



Since in the runtime routines used, the maximum length of 
data bytes for this type of storage is 252. this gives a set range of 
0lltrough2015. 

The Modula-2 specification is a bit more specific about how 
sets are to be represented, at least for those that will fit in a 
machine word, longer sets are considered optional. In Modula-2K 
sets are stored in one byte, two bytes, four bytes, or a multiples of 
4 bytes. A set thai fits into one byte is any that has a maximum 
element of 7 or less. Likewise, a two byte set goes up to an 
element of IS, and a four byte set goes up to 3 1 . The four byte set 
is also a predefined type called a "BITSET'. Sets who have iheir 
maximum element greater than 31 are stored as multiple of 4 
bytes, for whatever size they need to be, within in limits of 
available memory. 

This makes sets useful when dealing with I/O ports. For 
Distance if you have an 8 bit I/O port thai has 8 lines, the Hist 
four (bits 0-3) are input switches, the other four (bits 4-7) are 
lights. 1 nis port could be defined as : 

type 

switch = lie ft, right, up, down) ; 

lights - (down: error, proceed, standby, destruct) 



control I5F3400] : set of left .. destruct ; 

The [SF3400] tells the compiler that this one byte set 
variable is to be located at hexadecimal location F3400. One 
could check to see if the up switch is on by using : 

if up in control 
then 

<perform operation> 

You can turn on the standby light (without affecting ihe 
other lamps) by using : 

incl (control, standby) 
or control :- control * (standby) 

The more conventional method would be : 

const 

Up = 4 ; 

standby - $40 ; 
var 

control ISF3400] : shorthex ; 
begin 

if control and 4 <> 



then 

<perform operation> ; 
control :- control or $40 

A similar capability (but not using set syntax) is available in 
C and is called bitfields. It is not applicable for sbuclures larger 
than 4 bytes, and bitfields are implemented in only a few compil- 
ers. 

Pascal defines I/O devices in the language itself, and so has a 
device type, which is a more general version of the standard Pascal 
file type. Modula-2K and C provide I/O facilities using external 
procedures, so no real comparison can be made here, we will cover 
this in a later month. 

Ihe last data type is Ihe pointer type, which is very important 
in most real-time and systems programming. Pointers are essen- 
tially the address of something, and so by definition on the 68000 
series they are 4 byte quantities. A pointer to an integer is declared 
something like : 

PASCAL MOQUIA-2K C 

Intpt : "integer Intpt : pointer to Integer lr\t 'ln.pt 



Assuming we have put a value into a pointer, we can access 
the data it points to by "dereferencing" it, for example to assign ihe 
value of 5 to where the pointer points to : 



PASCAL AND M3DULA-2K 
intpt" :• 5 



C 
•intpt - 5 



Ihe main use of pointers is in dynamic data structures, where 
a block of memoty is obtained from the environment and used to 
store information. Since the compiler cannot know where this 
memory will be, a pointer is usad that has it's value determined at 
run-lime. 

Pointers are often used in C to access I/O ports since C lacks a 
simple way to determine at what address a variable will located, in 
this case the pointer is loaded with the location of the I/O port. 
Most compilers will accept something called a "caste" that does 
allow access to a specific location without using a pointer, but the 
syntax is a bit murky and will be discussed in the section of 
variable allocation, which will be in a later article. 

Now let's talk about constants. Boolean constants are TRUE 
and FALSE for Pascal and Modula-2K, C doesn't have a boolean 
data type. Character constants have a number of forms in each 
language, depending on whether or not the character value is 
printable and what base you to use. 

In Pascal printable character constants can be specified by 
putting the character in between single quotes, such as 'X'. If you 
need to specify a single quote as the character, then use two single 
quotes next to each other, which will be treated as a single 
character and not as a delimiter, such as "". Numetical values can 
be specified as well, for instance, each of these represents decimal 
15: 



46 



July -88 



66 Micro Journal 



DECIMAL 
115 



HEXADECIMAL 
♦ SF 



BINARY 

ttoooomi 



In Modula-2K printable character constants can be specified 
by putting (he character in between either single or double quotes 
(but no) a mixture of the two), such as 'X' or "X". Double quotes 
are normally only needed if the character you want to represent is a 
single quote, the dual single quote trick doesn't work for Modula- 
2. Numerical values can be specified as well for instance, each of 
these represent decimal 15 : 



DECIMAL 
US 



HEXADECIMAL 
\SF 



BINAR* 
\%00001111 



OCTAL 
17C 



. In C printable character constants can be specified by putting 
the character in between single quotes, such as 'X'. A single quote 
is represented by V . Numerical values can be specified, but only in 
octal (who uses octal anymore?), decimal 15 woutd be : 



In Pascal and Modula-2K these would be considered as real 
constants, in C they are double constants (there are no float 
constants in C). In order to get a longreal constant in Pascal and 
Modula-2K we need to do one of two things , either follow the 
number with the letter "L" or use the letter "D" for the exponent 
port instead of "E". 

Array and Record constants are handled by all thrae lan- 
guages, but their syntax has its roots in van able declaration and 
allocation, so let's leave that one until later. 

String constants are very similar to character constants, but 
include more than one character (a string constant with only one 
character is generally considered to be compatible with characters). 
Pascal again uses the single quotes, and to represent a single quote 
you use two of them together. Modula-2K uses single or double 
quotes, at the programmer's whim. C uses double quotes. How do 
we add non-printable characters Co a string? We use "escape" 
characters to do it. For sake of example lets assume we want to 
have the siring "lest", followed by dacimal 15, followed by" 
done". 



OCTAL 



U7 



Integer constants are normally written as a seiies of decimal 
digits. Decimal constants (without an exponent or decimal point) 
are considered to be integers unless they are larger than integer 
size, in which case it is longinteger. In some rare cases, you might 
want to explicitly specify that an integer is short or long, in this 
case you can follow the number with the letter "L" to specify long. 
In Pascal and Modula-2K, a short integer can be specified by 
following the number with the letter "S", C apparently has no 
method of specifying a short integer constant. Unsigned constants 
can also be specified using a vaiiety of forms, the following 
examples use the decimal value 15 again : 

PASCAL 

shore Integer 15s 

integer IS 

long integer 15L ' 

unsigned (hexadecimal) SF 
unsigned (binary] toOOOllll 
unsigned (octal) not supported 17B 

Floating point constants are pretly much standardized 
between languages, and are available in two formats, with and 
without an exponent, such as : 



MODULA-2K 


c 


ISs 


not supported 


IS 


15 


ist 


151 


sr 


OXF 


100001111 


not supported 


17B 


017 



4.3 



G.3e-S 



4031E205 



PASCAL MODULA-2K C 

'test' 115' done' 'tesf\15' done' "testMl done- 

Set constants were discussed in the saciion on sets. 

There is really no such thing as a pointer constant, you just 
use a signed or unsigned constant. 

Next time we look at how variables are allocated and 
accessed. 

OmegaSoft is a registered trademark of Certified Software 
Corporation, UNIX is a trademark of Bell Laboratories. 



Editors Note: This is part 1 of a 2 pan series. Part 2 was 
published ahead of part 1. Please refer to the June issue for pan 2. 
My apologies: Larry Williams 
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Bit-Bucket 




By: All of us 

'ContriSuu Tfothing ■ tjq>ut TfptAing ", DMW '86 



Dear Don. 

Ihe recent request Tor articles on the ATARI 68000 
machines and the interesting article by Dale Randall, 
prompted me to expand on his list of operating systems 
by describing the ATARI versions oroS/68K and IDRIS. 

J too started out with a SWTP 6800 In May of 1976. 
though with only 2K of memory! It Is now a 2 MHZ 
6809 with about 340K (Including almost all FLEX 
utilities In EPROM). The unit Is still used several times 
per week, though I no longer write any new software for 
FLEX. Its primary use is to serve the ATARI for testing 
programs and passing Hies between the many ATARI 
operating systems. For many years I claimed t would 
never allow an "appliance" computer In my house. My 
aversion to "closed box' computers soltened when 1 
realized the only way I could Just Ify a 68000 machine 
was to buy an ATARI ST or COMMODORE AMIGA. I 
wont go Into the "68000 WARS", suffice it to say our 
group of Motorola fans bought ATARI machines. 

Dale has already discussed GEM. MS-DOS. CP/M. 
and MACINTOSH so I will move on to what Don Wil- 
liams calls "serious software." I purchased OS/68K 
fiomTLM Systems back In September 1986. It cost 
more than the computer and was a long time coming, 
but well worth the wait. I found Mlcroware's part (the 
operating system) to be very smooth. TI.M's part (the 
ATARI specific programs) was rather sloppy. I soon 
developed a rapport with TLM as I sent In pages of bug 
reports. Unfortunately TLM went belly up before all of 
the bugs were fixed. Mlcroware took over the ATARI 
version of OS/68K and eventually updated me to 
Version 2 and solved most of the ATARI specific prob- 
lems. 

OS/68K runs well on the ATARI, though It doesn't 
take advantage of the ATARI capabilities. Like most 
UNIX style operating systems It was Intended for a 
separate serial terminal. The promised windows never 
arrived (the COCO III Is still the only windowed OS/9 
I'm aware of). The system Is fast, much faster and more 
responsive than UNIX. The 68000 running at 8 MHZ 
with 1024K of RAM makes an effective engine for OS/ 
68K. For those unfamiliar with Version 2. the old load 
and link method of keeping often used programs In 
memory has been supplemented with the "Sticky or 
Chost BIT." It's sort of a "command cachelng" system. 
As you use utilities they are kept In memory unless a 
memory hungry program needs the space. Thus before 
long I have the complete compiler, editor, and several 
utilities In RAM yet I still have room for a 256K RAM- 
DISK. 



OS/68K has many other features I like, such as 
recall of the command line (control A). This Is enhanced 
by allowing trailing options. For example if you enter 

copy /DO/source/c/dc.c /hO/source/c/dc.c 

and you are greeted with an error saying the (lie 
exists, you need only type Control A followed by -r. On 
most UNIX systems you would have to type the line 
over. Inserting the option between the command and 
the arguments. I enjoy havtng the ability to do a 
sysgen. all other systems I've worked with were shipped 
"Like It AS IS or leave It." I have added drivers and 
utilities to the Os9Boot file to customize It to my needs. 
Mlcroware expects you to spend more than the cost of 
the operating system for Information on adding drivers; 
I spent some educational nights with a reverse assem- 
bler and was able to add several new drivers. 

On the negative side. OS/68K Is not UNIX. I work 
with UNIX on a variety of systems, and It is AWKWARD 
to go back and forth. I have added several UNIX-like 
commands to Mlcroware's command set. but still lack 
several more that are too UNIX dependent to port over. 
OS/68K procedure files are light years behind UNIX 
script files, they lack parameter passing, conditional 
tests, and looping. Slowly Mlcroware Is heading that 
way, I've noticed several UNIX- like enhancements in 
Version 2. 

I also suspect Mlcroware really didn't want to take 
up ATARI support when TLM went down the tubes. 
Their response to most questions Involving improving 
the ATARI port Is "Perhaps some day." They even 
dropped several features TLM had developed, such as 
control over the display and keyboard. 

On to IDRIS1 For Ihose unfamiliar with 
Whitesmith's IDRIS system. It Is a UNIX compatible 
system running on several Motorola 680XX and DEC 
PDP/1 1 machines. It meets the IEEE POSIX and ANSI 
standards for UNIX compatible operating systems and 
C compilers. I recetved It February 1968. and have 
enjoyed working with It. IDRIS Is close to UNIX V6. but 
some utilities are of later vintage. There was nothing In 
the advertising to Indicate It would be three generations 
behind the current lelease of AT&T UNIX: except 
perhaps the mention that ATARI lacks memory man- 
agement. Tills has not been too much of a limitation. 
Just an Inconvenience. I have already replaced a few 
utilities with newer versions, soon I hope to replace the 
shell. IDRIS Is so close to UNIX It is possible to port In 
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programs (shell. And. Is) that deal with the disk struc- 
ture at fairly low level. 

UNIX systems are SLOW compared with operating 
systems aimed at smaller computers. The disk struc- 
ture slightly resembles the linked list of FLEX except 
the links are kept In tables called 1NODES (pronounced 
"eye-nodes"). File writes are done one 512 byte block at 
a time, adding block numbers to the list as you pro- 
ceed. Traditional UNIX programmers are resource 
frugal to the exfceme: I've seen a program make thou- 
sands of calls to the operating system to allocate 2 
bytes at a time rather than a few calls for larger chunks 
of memory. 1DRIS doesn't keep finished programs 
around like OS/68K. nor does It share one copy of a 
program. If while editing one Hie I call the editor with 
another file I will have two copies of the editor In 
memoiy. It does have disk sector cache, however. 

The ATARI port of IDR1S was done by Computer 
Tools International who deserve credit for a Job well 
done. Unlike TLM my bug list Is quite short (can't get 
the Memdlsk to work, a few manual typos) . Unlike 
Mlcroware they seem to like the ATARI: Included are 
utilities to deal with the display, keyboaid. mouse, and 
MIDI ports. Both OS/68K and 1DRIS support the 
parallel and serial ports, as well as the Hopples and one 
hard dilve. 1DRIS has a program to catalog and retrieve 
GEM files. 

What article comparing operating systems would be 
complete without some speed tests? The following time 
trials were done on an ATARI hard disk with no effort to 
"tune" the operating systems. Since I don't have the 
1DR1S Memdlsk working. I tested OS/68K with and 
without anything loaded In RAM. The program was 
found on the back cover of 68 MICRO JOURNAL. 
Examining the source code generated revealed the OS/ 
68K compiler generated a three Instruction loop 
whereas the 1DRIS compiler generated a four Instruc- 
tion loop. In fairness to the 6809. I should mention that 
for 60000 loops (register short) FLEX beat the 68000. 
All this should be taken with a grain of salt since it 
only tests a tiny facet of the compiler. 



applications aie not available. Just that the few I'm 
Interested In are prohibitively expensive. I spent $200 
for an OS/68K disassembler (SLEUTH) and found It 
wasn't OS/68K compatible ( Editor's note: ••ee letter 
below from Dr. Bud P«m.) Oh It functions, but It 
doesn't recognize OS/68K binaiy Hies, doesn't recog- 
nize OS/68K headers, doesn't recognize OS/68K 
system calls, occasionally crashes by reading address 
zero, and even generates some mnemonics that the 
OS/68K assembler doesn't handle. It seems Bud Pass 
never finished the product since there Is a large airay 
of OS/68K system calls In the source he never usedl 
Over on the "game-toy* operating system (GEM) I have 
disassemblers that run circles around SLEUTH. 
Though 1 dearly love the popular STYLO word piocessor 
(I bought the source years ago from Sonex Systems), 
there are GEM word processors that have modem 
features that STYLO lacks. A few examples are: Built In 
Dlctlonaiy which suggests coirect spelling, and Inseits 
the corrected word. Thesaurus to check your choice of 
words as you write. Italics, bold, and even type faces on 
screen. Cut and paste between documents In four 
windows. Surely anyone who has used a mouse 
machine like the Apple Macintosh knows you don't 
have to have OS/68K to do "serious* computing. 
Rather, systems that use serial terminals Instead of bit 
mapped displays are limited for serious word piocess- 
Ing. graphics. CADD. and desktop publishing. 

In conclusion I'll say OS/68K and 1DRIS are 
keeping me busy doing what I like best: writing and 
porting C programs. FLEX users know I have always 
preferred wilting utilities to do things rather than 
actually doing them! If running applications was my 
forte, I'd llnd more programs to run with GEM, PC- 
DITTO, or MAGIC-SAC. 

Leo Taylor 

109 Twin Brook Road 
Hamden, Conn. 06514 
(203) 387-9658 

Don MiUiJil. Cditor 
66 Hlcco Journal 
)900 Cassandra S»nh 
Hixicn, tN 1114) 



main E) 

/■ km. i; ■/ 

register long i; 

for ti-0;i<999999;++i); 





FLEX 


GEM 


OS/68K 


IDRIS 


COMPILE DISK 


35. 


12. 


27.8 


49. 


COMPILE RAM 


24. 


1 . 


10. 




RUN INTEGER 


76. 


9. 


6.8 


9. 


RUN REGISTER 




6. 


4.2 


6. 


COPY 100K FILE 


45. 


5. 


15. 


16. 



Finally I'd like to comment on the "serious solt- 
ware" nature of OS/68K and IDRIS vs the *game-toy" 
nature of GEM mentioned by Don Williams. So far I 
have about 500 application piograms for GEM, 2 for 
OS/68K and for IDRIS. That is not to say UNIX style 



3#*r Don; 

As Leo Tayloi aeniioned in Mi letter to the editor in 64 Hicro, 
the current vtruon of fiupfi Sleuth Eor the 49010 was deiboned to 
disassemble bBOOO* feBOOB, and 6B010 machine code, which it dot*. 
Ttut current vetlior has no current known bo?*. I nave used it 
(or aoae aubatantial disassemblies, and cuitoneti haw* reported 
■ ucceaaf ul Ly ui 1 no it for disas*e»t>L 1 ng aeverai large pro*"raa*. 
including oonitors and operating eyste**«. 

The OS9/6S000 version of Super Sleuth does not currently procea* 
the OS9/&80O0 header and system calls; however, it will process the 
remainder of the nachm* cod* properly. The table of system call* 
in Super Sleuth l ■ not current ly u*ed. but i* (or use in the future 
version. Both the foreiit of the OS9/6800O fil* header and the exact 
format of the OS9/6flC0c *y*tm call* ar* bsdly-dccunanted* ■akin'- 
this task avert aort difficult than it wa* under OS9/6B09. 

This sy*t«P-*pvcif ic k-ifo-aatlon will be processed In ■ future 
vtrnon of Super Sleuth which will alio process the UNIX V header 
a>nd *yste« cal la . 

Incidentally, Leo Taylor's description of the UNIX fil* aysl**) I* 
not sccurst*. it is subatsnt i*l ly tort robuat than hla description 
would Indicate. There are alio cvo aajo- current veralon* of the 
file eyettn. a* originated by Berkeley and ** oriQtnated by AT&T. 
Thoee who are interested nay read one of the many book* describing 
the internals of the UNIX operating syste«. 
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tear Don. 

This ia by way of a continuation of my last letter, 
where I ran out of roan before I could get down to my 
expansion of XBASIC XPLANATIONS. So here goes with 
what I think will be a useful discussion of the logic 
functions OR and AND. As usual, we'll begin with the 
filnple and work up to the more complex. So let's look 
at a fairly carmen occurrence in BASIC programs. 

100 IF X% < 3 GOTO 120 

110 Y» - 9 

120 rest of program 

Nothing to do with logic functions yet. but observe 
that the program will fall through to line-110 only if 
X% >■ 3, and then carry on to line-120. Therefore we 
could re-write this segment as 

100 IF X% > 2 TBQJ Y» - 9 
120 rest of program 

provided there are no calla elsewhere to line-110. 
No, the *2* In line-100 isn't a typo! Because X% (on 
integer) can only take on the values ... 1, 2, 3, * 
..., then "> 2' is obviously the Bane as ">- 3*. Now, 
how about 

100 Df X% < 3 GOTO 1000 
110 IF Y» - 9 GOTO 1000 
120 rest of program 

Always provided there are no other calla to line-110, 
we note that we get directed to line-1000 under tve 
conditions (i) IF X% < 3, or, failing that, (ii) IF n 
■ 9. So we can re-wzite this baby as 



100 
120 



U X* < 3 OK Yl 

rest of program 



9 GOTO 1000 



But s^fOBe the program had read 

100 IF X% < 3 GOTO 120 
110 IF Yl - 9 GOTO 1000 
120 rest of program 

I hope you'll all resist the temptation to shorten 
this one by merely swapping lines 100 and 110, and 
then eliminating the new 110 as being redundant. 
Let's study it a little further to get the "logic" of 
it all. 

Our first observation is that the program will fall 
through to line-110 if XI > 2 (rsnember our earlier 
example), and then only if Yl = 9 will it shoot off to 
line-1000. Therefore the correct re-structuring of 
this would be 



loo if x% > 2 tm y% 

120 rest of program 



9 GOTO 1000 



Got it so far? OK then, let's look at 

100 IF X% < 3 GOTO 120 

110 IF Y% - 9 GOTO 1000 ELSE 2000 

120 rest of program 



After our previous example this one's easy! Just re- 
write it thus 

100 IF X% > 2 MD Yl 9 GOTO 1000 ELSE 2000 
120 rest of program 

Agreed? If you said YES, then you'd be wrong, wrong, 
wrong 1 This is not. the same program any morel Mty 
not?, you ask. Hell, for one thing, note in our 
original program that having reached line 100, it's 
possible (if X% < 3) to go to line-120. But that ELSE 
makes all the difference in the world, as there's now 
no way at all for our new program to reach line 120. 
Prom line-100 it can only go to line-1000 GR ELSE to 
line- 2000. So ... if you're tempted to re-write a 
line containing an IF -"IBB)- ELSE, my advice is to think 
again, and preferably resist the temptation 
altogether, or else be prepared for trouble. 

Now for something a little different. Suppose, to 
keep it simple, we've written a 9ane where, let's say, 
three or more players in turn key in a random letter 
of the alphabet (each one unseen by the others), and 
the player who keys in a letter which matches that 
keyed in by the player 2 positions back becanes the 
winner. Thus in the sequence QB3CMLM, the player who 
keyed in the final *M* would be the winner, as there 
is a match 2 positions back! 

Our game, then, builds up a string PS as each letter, 
XS, is entered, and the program would check thus, 
where X% is a count of letters keyed in. 

10 request inp.it (XS) , bus? x%, and add XS to PS 

100 IF KIDS(PS,X%-2,1) - XS GOTO 200 

110 HUNT "No match": GOTO 10 (ask next Player) 

200 HUNT "You win!*: DC 

Do you see why this program would bomb? Problem is 
that for the first two responses, PS wouldn't be long 
enough for us to look back by bvo positions, so "X%-2" 
would cause the HIDS function to fail. OK then, let's 
change the essential part of this program to 

100 IF X% < 3 GOTO 120 

110 IF HIDS(PS,X%-2,1> - XS GOTO 200 

120 HUNT "No match": etc 

200 HUNT "You winl": END 

There, that should take care of that! Agreed this 
time? Take another look before you answer! If you 
said YES this time you'd be correct. But then, by 
applying our earlier principles, and noting that we 
fall through to line-110 only if X* > 2, we can now 
shorten this to 

100 IF X% > 2 AND nlDS(PS,X%-2,l> • XS GOTO 200 
120 etc 

and we're still in business! Right? Although this 
seems intuitively correct, we'd be be creating 
problems with this approach, because XBASIC and 
several other BASICs too (including RBASIC) , evaluate 
a coaplet* logic function before making a final 
deciaion. Thue, even though X% were, let's say, only 
equal to 1, it would not 1—nMatmly fail and fall 
through to line-120, but would carry on to evaluate 
the remainder of the logic fi#>ction coupled to it by 
the AND statement. And would bomb under these 
conditions in its evaluation of PS. 

On the other band, the following 

100 IF X* > 2 THEN IF KIDS (PS,X%-2,1> - XS GOTO 200 

would work OK, because there are now two distinct 
conditional IP-TBENs to check, and a "fail" on the 
first 0C« > 2) ««jld immediately drop through to line- 
120. So you Bee that AND is not altwr* equivalent, to 
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THEN IF (certain publications notwithstanding), though 
it would be in tbe following instance 



and 



100 IP Xt < 3 AND Yt - 9 GOTO 200 

d 

100 IP Xt < 3 THEN IF Yt - 9 OTTO 200 



The difference, of course, is that the second 
conditional (Yt - 9) is independent of the first, 
unlike our PS example, where it's essential that the 
"Xt - 2" In the second conditional evaluate to *1" or 
■ore. 

A further example to round out this part of my 
discussion. Beginning with, let's say, 

100 IP Xt < 3 GOTO 120 

110 IP Yt - 9 'IHQI Zt - 5 ELSE Zt - 17 

120 rest of program 

the program baa to arrive at line-120, one way or 
another, with Zt set to some value, so it should be 
perfectly OK to re-write this as 

100 IP Xt > 2 AJD Yt - 9 THEN Zt - 5 ELSE Zt - 17 
120 rest of program 

Here, too, we'll arrive at line-120 with zt set to 
some value, so everything's OKI Again, take a good 
hard look rather than just blindly agreeing with me. 
And again, if you did agree, you'd be wrctigl What's 
wrong this time? Hell, in our original program, it's 
possible for Zt to arrive at line-100 with any value, 
and under the condition (Xt < 3) to retain this value 
as it gets re-directed to line 120. But, if (Xt > 2) 
it would fall through to line-110, and change Zt's 
value to either 5 or 17, depending on the second 
conditional clause (Yt - 9) . 

In our re-write, however, the original value of zt 
will alvaya be changed to either S or 17 before 
continuing to line-120, with absolutely no possibility 
of retaining its original line-100-value. So, here 
too, if we wish to retain the intent of the original, 
we HOST replace our MD with a 1HB IP, even though 
the two conditionals, depending on Xt and Yt 
respectively, are apparently independent. So this is 
the correct form 

100 IP Xt > 2 THEN IP Yt - 9 THEM Zt - 5 ELSE Zt - 17 
120 rest of program 

So be very careful with those IP-THEN-BLSE 
combinations, and always check against the Intent of 
the original! II 

Soma BASICS, even in our P$ example, decide 
(correctly) that if the first conditional Is PALS 
then it' 8 pointless to check any other conditional 
linked to it by no. and would fail immediately. This 
capability, however, takes a lot more code to 
implement in a BASIC, which is why I, and others, take 
the easy route and evaluate the whole function, no 
matter what I 

Similarly with an GR function. The oxutt oat of the 
OR conditions is TRUE, it would logically be pointless 
to check any other conditional linked by or, bit again 
... core code. 

I'll have more to say on this subject later, but for 
now, enough is enough! 



Don Williams, 

68 Klcro Journal , 

5900 Cassandra Smith Road, 

BixBon, TO 37343 



Sincerely, 

At 

R. Jones 
President 



Noel M.Moss 

14 N. Kingshighway Blvd. 

St. Louis, MO 63108 



Gentlemen: 

I recently discovered a resource thai your more technically 
oriented subscribers may be interested in. Motorola runs a 
"Freeware" bulletin board system thai has downline 
loadable cross assemblers, cross compilers and utilities. 
Theese lools are intended for use on PC's, MACs and a 
few other machines. 

The cross assemblers include the following target 
machines: 6800/02, 6801, 6804, 6805,6809and 68HC1 1. 
There are also a few small C-compilers, a Keimit utility 
and assorted odds and ends. The tools seem to woik within 
certain limitations such as little or no macro suppoil, etc., 
but they are FREE. 

I had occasion to use the 6800 PC resident cross 
assembler for a recent project to update some ancicntcodc 
and found thai the assembler reported "Unrecognizable 
Mnemonic" for ihe ABA instruction. I have left a query 
on Motorola's message system but have noi had a 
response yei. The simple fix to this problem is lo code: 

ABA EQU SIB 

then insert: FCB ABA 

whercever ABA is needed. This approach also allows one 
to implement 6801 unique mnemonics on a 6800 
assembler. 

The telephone number for ihe freeware system is: 
512 440-3733 

The system supports 300, 1200 and 2400 BPS. When ii 
answers, simply type one or two carriage returns for 
autobaud. It seems to be up 24 hours per day bui I have 
run into a few instances where ihe modem answered bui 
the system wasn't home. 

Sincerely, 
Noel M. Moss 



Dear Sirs: 

In past issues you had letters from readers printed. I've not 
seen them in recent issues. If possible could you ask this 
question? Does anyone still use ihe 6800 CPU? And if so 
would he please write me. I'm still using this CPU. 

Also I would like to know if some of the older companies 
still have or support this CPU. Companies like CSS, 
TCS, Microware, eic. If ihey do, can you give me there 
present address? 

Sincerely, 
John J. Fiorino 
518 85th Street 
Brooklyn, NY 11209 
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University Research end Development Associates, Inc. (UPDA, Inc.) 
has just announced The P68O20 iilAB'" microprocessor development system, Ihe 
toorin in Ihe UHOA ulAB'" series The P68020 mLAB'" Is a Moloiola 68020 32 t»t 
rmcropfDcessor with support chips, oplional Iterating point coprocessor <6BBBt). 32 K 
SRAM. 8 K EPROM, Monitor. 32 bit program operation tiont the SRAM and User 
Manual. 

Packaging is a single board eKpnnsian lor the P6SOO0 ttLAB™ through two 50 
conductor nbbon cables The P68020 uLAB"* uses Ihe keypad, display, power 
supply, etc . ol me P6600G uLAB"* which is required lor operation and sold separately 
by USOA. inc. 

The P68020 uLAB"* io a stale ol Ihe arc 32 bit microprocessor system providing 
individual hands on experience at an economical price Several options are 
available A complete operallonal system including both Ihe 68020 and 68881 
(Hoatiiifl point coprocessor) chips as well as a serai pon end a 6B020/668B1 cross 
assembler lusted on a PC costs only 5699.50 (Separately Purchased Pries 
*924 «S) 

To uodale a P68000 iiLAB'" mat you now own, deduct St 97 SO II you dont 
need a floating point coprocessor, deduct SMS Thus. Io upgrade your currenl 
PeeOOO uLAB"- io Ihe 32 bu Motorola 68020 with 32 X SHAM, the cost is only 
S372S0 

Traditional development systems require many times more cash expenditure, 
laboraloiy space, laboratory monitoring and scheduled access The uLAB ,M 
overcomes all of these limitations The uLAB 1 " is engineered to be low cost providing 
hands on expenence tor engineers, technicians and students 

The User Manual contains a complete description Of the system operation 
including explanation ol all key functions, memory map software, utilities, and 
programming examples including Sound (Tone) Generation, and Visual Display 
examples 

The user can conveniently carry the Notebook Computer"* io the home, 
dormitory, or other work or study location to expenment with Ihe microprocessor ai 
his/har convenience providing laboratory type capability, or it can be used in 
conruncimn wiih lecture type courses without the addlional laboraloiy expense and 
inconvenience , 

The P68020 uLAB'" and previously announced uLAB"" microprocessor 
development systems provide for inexpensive Simultaneous aecess to a number of 
processors herelolore available only on a 'one at a time* basis Irom expensive 
multiple target microprocessor development systems 



Optional accessories lor the itLAB" include 

(II P6668I uLAB'" senal I/O io ihe IBM-PCS arid MrXSmotrxJ ai JSS SO 

(2] P6B020ASM Cross Assembler to run on an IBM-PC® or suitable clone, 
at tl« 95 

(3) PADC-DAG-B uLA8™ B channel. 8 bit analog to difljlal/digiial to analog 
convener at $197 SO 

(4) PWWEB-2 Wire Wrap expansion with 6 documented experiments and 
wire wrap tools at Jso CO 

(5) PBURN ULAB'- EPROM Burner for 2716. 2732. 2764. 27128 and 27256 
EPROMS 

A Summary ol the P8BO20 uLAB'- leaiures 

' Ag sodiets. wiring, and support chips tor the Motorola 68020 32 bit 
microprocessor (the Motorola 68020 chip must be ordered as a separate 
unit 

• 4 K, byles Moniior and Utltly EPROM 
■ 4 K bytes User expansion EPROM 

' 32 K byles ol static HAM 
' 32 bit bus out or SRAM 

* Detailed User's Manual inducting schematics, programming instructions, 

and operating system listing 

FOd PWces AHO OftDBHNO. call unoa. lnc_ 

Unlverally Research and Deveiopmeni Associates, Inc. 

4516 Henry Street, Suite #407 

Pilisburgri, PA, 15213 

1-800-338-0517 or 1-412-683-8732 
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Low Cott MC68020 SBC Serves as MDS or Te gel 



Windrush Micro Systems Limited are pleased to announce Ihe 
immediate availability ol low-end ftmega workstations lor the 
educational and OEM target system market. 

The basic system incorporates a 12.5 MHz MC68020. 512K ol zero 
wait-slate static RAM. live RS-232C serial potts and a parallel printer 
port, 

This system is supplied with floppy and SCSI interlaces (but no drives) 
and OS-9A58K Professional lor E1 .595.00 (1 oft) or OS-9/68K Industrial 
lor El. 495 (10 oil). 

A single 1 mb 3.S" lloppy disk drive adds £135 and a single 20 mb Hard 
disk adds £375. 

The standard range ol fimoga I/O cards can be used with these low cost 
models. These include: A colour graphics adaptor which provides a 768 
x 576 x 4 bits/pixel resolution. Up to sixteen colours Ifom a palletle ol 
4096 colours may be displayed simultaneously. Other options Include a 
9-Port serial expansion card, a 3 Mb ROM expansion card. tOO - 340 mb 
hard disks and 1 50 mb tape backup. 

The lop ol Ihe line fimega workstation, costing £4950 Incorporates a 16 
MHz MC68020 processor and MC68881 math co-processor as standard 
and Includes live RS 232 ports, a 40 Mb Winchester hard disc with a 
seek timed less (man 30 mS. a 1 Mb 3.5 inch lloppy disk, a 150 Mb 1/4" 
tape streamer. 2 megabytes ol zero wait-state, non-voralite Sialic RAM. 
A parallel printer pott, a clock calendar and OS-9/68K professional are 
also included 



For further information contact Bill Dickinson at (0692) 4040B6 



® 



Joyce wUHana 

€3 MICRO JCOPNAL 

*590D Cassandra South Poed 

Hlxton, TTe 37343 



May 13, 19B7 



arioua hoe I / targp t models of C 
cross-coftpi ,«?r synlemc and 
.hat we're oifeeinq these day*, 
cross-developvent products are 
ficanlly iOiC 'expanded' and 
co*pllrrs we were *e ) 1 1 ^9 for 
j back, Mao, yoti'tt notice 
ry vide variety of development 
need products are aval lable 



Dear Mrs . Mi I liana. 

The enclotur»B Identify the 
croaB-con.pl lee ayeterat, Hodula-7 
macro relocating croia-aatenblere t 
As you are probably aware these 
several generations rxjwer and signl 
more Capable than the resident C 
UnlFlex, Flex, and OS9 several year 
that although we now support a ve 
hoatn, none of theae newer and enha 
for $fl09-taaaed developt>ent ayatena. 

Ae I'd mentioned when you phoned yesterday, although our 
current fatally of product* la oriented toward* user* who are 
doing their software development on pc/XT/ats. VAJtea, and various 
Of the wore popular worketationa .SUN. Apollo. HP 9Q0Q- etc) we 
car still supply copies of our older, version 1.6 resident C 
compilers under UnlFtex, flex, and 059 and the retail price for 
those packages Is still $W5. Though we haven't advertised nor 
proeoted the aval lability oT our 6B09-baacd software tool a for 
the paat 3 or 4 years now, surprisingly enough we still do get sn 
occasional order for s OniMex or OS? copy /tofn t i me to tiaw?. 

Glad to hear everything it going well at «$fl Micro Journal. 
Pleaee give «y regarda to Don. 

ppai regarda. 



John HlaialoNskl 
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GESPAC Inc. 
SOWMtfrtoovwAv*. 
Mm, A/UOAS $3202 

T«i. (602) 962-5559 
FAX. (602) 962.5750 

cisrAca low cost eaooo hulti-oser siirflLR 

•ORRD SYSTEM COKES WITS C AJPD 03-S IM ROM 



VESA, AS, May 18/ 1*BB--CB3PAC Introducti thi GESSBDS-B. 
■ rivolvtlooiry single board multi-uaar coaputer ayatea 
with oeerly S12K of ROM reaideot software. The OESSBDS-6 
lata up to two uaara progrea directly in C or ISOOO 
■■■■•bly language under tha powerful OWIX-lika, 03-9 
real-tiae oparatlog ayatea 

Tha GftSSBOS-C • log la hoard aye tea la aiaed at ayatea 
eagloaara daeirlogj to build aiaipla reel-tlae control 
ayatemi with vary faat turo arouod. Tha OESSRdS-S la 
alao a vary powerful aod lpaspenalve teaching tool for 
eogloaera who want to femlllerlee tbeaeelvee with C, 
r nl t i e« »u)tL-tiiUnij operating ayataaa . 6 6000 

•icroprocaaeor prograaaing techniques and fl-6* bu a 
ayataa architeoturee . 

The geSSBdS-6 ia totally aelf contained end oeeda no 
additional hardware auch aa external diak drlvea for ita 
operation. The cr3SflOS-6 provldee the veer with en on- 
board, hettery maintained 126* noa-wolatile CMOS RAHdiik 
for atoring aource and object f ilea . The CE3SBD3-6 coaes 
with detelled uaar documentation thet lete even the 

Qovlca uaer begin writing hia or her flrat prograa only 
aioutea after unpacking the ayataa CtSPAC of far a an 
optional 20W eicternal switching power eupply for the 
ay 1 1 •■ . 

The GESSBSS-6 ia reedy to grow with the uaer ' e oeede. At 
any tia«, it la poaaible to add floppy diak and herd 
diak atoragei two additional uaera. a parallel printer, 
end up to 8 Mbytee of additional aeaory. Zt aleo ia 
poa elble to expand tha CE33BDS-6 ayataa with any of over 
ISO t/O aodulee manufactured by GESPAC. 



Tha GS3SBD3-6 lncludea the following aoftware: 03-9 v2 . 1 
Oparatlog Syataa with 2? utilities, C language coapl ler, 
Syabolic debugger. Relocatable linker, 66000 

relocatable, and Screen oriented teat editor. The 
CESSBD3*6 la available today at the low unit price of 
$1495 for the board and the aoftware. 

GESPAC INTRODUCES 6 8 000/20 
CROSS DEVELOPMENT SOFTWARE fOR TEE IBM PC 

Hasa, AS, April 30. 1988 — GESPAC introduced a aoftware 
package thet ellowe the development and debug of 
(8000/BB020 coda on a atanderd IBM PC, PROBE la a 
aoftware monitor which raaldae la a Q-64 but (8000 or 
48 02 target bond and intarfacaa to a PC or AT 
through *n R5-232 aarlal link. 



Haadev Contact: 
Editorial Contact: 



TtaaBfiQQS 

Cosma PaboucUidls 



PROBE provldee aeny of tha aa a faeturea and uier 
interfecea aa ln-clrcult-aauletore. but: for only a 
fraction of the coit- The package 'a low ooet makee 
it evallible to aore developers in a aultiple pereon 
project , 

PROBE feature* ititi-of- tbt-tct debugging 
capabilltiee PROBE aupporta 14 breekpolote, 
ault lpla-t race and elngle-atap aodaa, aa wall aa a 
friendly, menu-driven uaar interface, PROBE ellowe the 
of display up to 10 diak files concurrently while 
debugging . Thia laat faeture alnialiea the need to 
generate llatinga for debugging. 

The aoat attractive feature of probe ie ite ability to 
■Ingle atap through C aource code directly. Alao. 
PROBE lete the prograaaar ui* the ayabollc debugging 
lnforaation froa hia code geoeratore lo place of 
absolute value*. Thia eliminates tedloui refereneea 
to abaolute nuaber ■ which change a vary tut tha 
program la linked. Tor exaaple, referring to a ■— ory 
location which haa been labeled "TOO" in the progrea 
le auch eeeler than determining the eddreee of TEMP 
during each debug eetaion PROBE aymbol table alae is 
practically un Hal ted. The PROBE ia coapetlhle with 
aeveral object module format! aod languagaa. 

Software con be patched on line by tha PROBE ayabollc 
aaaaabler. patchee can be lnaerted into the progrea 
•ymfiolically ualng the prograa ayabola. The etaodard 
68020 aaaembly language instruction* are uaed. PROBE 
eleo eupporta the 68881 nuaeric coproceeeor. Thia 
■•■di that coproceeaor ioatructlona are Included in 
tha raal-tiae trece display and unaaeeabla coaaanda. 
The progreaaer ceo alao diaplay end chenge coproceeeor 
regiatera directly. 

PROBE lete the prograaaar define hia own unique aet of 
debug coaundi tailored to the type of debugging he la 
doing. Theaa debug coaaanda, Kecroo, can be executed 
with e a Ingle keyatroke. in addition, it la poaalble 
to peea paraaetere to the aecroe to aake thaa aore 
generel purpose. The aacro oaaea ceo he aavad and 
loaded for future debugging aeaaiona 

The uaer can progrea PRORE to execute e aacro command 
when a breakpoint occure . Thia late the progracMar 
aet up complex teata which diaplay the information he 
wenta want to eee after each breakpoint or guide the 
PROBE to do additional taatiog of the target 
Tor aore information on PROSE, call toll free 1-800-4- 
CESPAC <io Aris one 1-602- 962-5539* . or write to 
GESPAC, 50 W. Boover Ave.. Weaa. AX 65210. 
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M) MOTOROLA tNC. 



Mlcroproc«»sor Products Group 
6501 William Cannon Drive West 
Austin, Texas 78735-8598 



Richard Muabclto 
Soity Micnnyticmi 



Dean Motley 

Micrcjnsce&sor Product* Group 

<5I2)440 2AJ9 



MOTOROLA INCREASES SPEED OF MOW TO 33 Mile 
Speed (ftctctwr Mike i 030 FASlttl GeneraiP&'pwe 32-Bil Chip AviihMc 

AUSTIN, Texas, lone I, 19X4— Moiamla 1od»y unnwrKid am cnlwrxennnl to Hs 
« bit frtfOUO iJimly wiih the development of ft 33 MHlfcKtfO <U3U> mk;fta>nx£iia> The <c<* 
chip is the faweit clock-ipccd. (CMnlpunxnf 32-bit nacfoprccuoron the market. In a 
ic^unie related announcement. Hewlett Packard artflouaced thai II will incwparoie the 
33 MHt 030 in a hj[h<ad model of thekr Send 9000 wort »at ion line. 

The 33 MHi©30 fobows the Apnl 1988 annuoeement of the 25 MHz 030. and the 
Ocioberl9S7inffc<luctionorib<030micAfc«D3Jft» u 20 MHi, MoiWDta 'a 68001 rvmiy.i 
njmjMtiWe line of microtuoEClsan thai hai generated the worid'i b/getl 32~h»l sofiwire and 
hardwwe rw . tntluacs ihc MMJ00 . 680 1 0. 68020, 6XQ50 and future 68O40 The vt.c. t» 
avibble atar-mprcf ^tCcdifrotii ft Mill to 33 MHt 

"The ability of ihc 030 to move to ihn hi£h cfcxk Jpe<d iw mbuie v> 1I1 de-dCn .md tnm* t 
ttack recoid tn manufacmnng t*id Munay A. Goldman, icntcf vice prettfeni and ^ncral 
manager of Mot»oOe'i Mtcroproctttff Producit Croup (Aujum, Tsxai) The •W» 
cnnpAiibiliiy with prcccdirtg 680trManuly pnwcKou will allow our cujfonvn lp tiuW .*Jd 
perfnrmance tOlhCif cutting lyuerm" 

HEWLETT PACKARD AND SONY INTRODUCE HIGH-END 

WORKSTATIONS BASEDON MOTOROLA 'S68010 

Widely Installed 66000 Base Continues to Support New Systems 

AUSTIN. Texas, June 1. 1988— Motorola today announced (hat two ccoipjnics. 
He wlto-Paciml ind Sony M kjcuyucntt. will irssorponic (he 68030 micro? naKtSDr into 
ibcirnspcctivewoHjuboa pmduct line*. Be** Hewlett-Packard*! Model 360 and Sony'* 
NEWS 1850 i«cwp«irMea2J MMi 68030 u accwra) proccmng uniund a 25 MHt 
68882 (kMiiflt'Polol copMBVaar r« nvihcnub^ opcrUoiu In addition. Sony's 
wojfeiafton uses a lerood 68030 ai an emhukkd contmiler (I/O processor), 

The 68000 luKcunwiUyha*fwr*TikTT^ni^Jioin^cmbrri- the 6SQ00. 6801 0. 
68030 anal 68030. Moanrala r\a» announced ocvelopmcnio' anent-gcrteraitan 
micnpnnctior, the 68040. In total, mora than 1 5 million chip j from tlte 68000 family 
power ■ variety of tpplicauiOTts including cupenmnpiiicn, engineering workstations, 
business com pi tberi and embedded control device*. All generations of the 68000 arc 
compatible with each other. 

'The 68UO0 pnwessor family will continue to drive much of ihc wcik&iiition 
market*" ***** Murray A. Goldman, »cmor vice president and fcncral manager of 
Mortarob'> Microcaw-r^aor F^oducti Group (Austin, Te«ui3 "Wc*rc tkdtcalcd to 
working closely with high-quality system vendors to ensure the success of 68000- based 
systems in the mutea.*' 

Hewlett Packaid cunrnily has mwe than 250.000 MotoroJ ■• based systems installed 
worldwide. Among these it the HI* 9000 workstation series thai includes ihc 68030-hased 
Model 360. The HP 9000 scries addresses mechanical and electrical design, test and 
measurement, and general scvcntific^hnicai computation. In continuing its cxsmnreneni 
to the 68000 family. HP also announced plans 10 Introduce a workstation based on a 33 
MHt version of the 68030 later this year 

Sony's NEWS 1800 technical workstation series, based on the 68000 family, is the 
market leader in Jspon and has more than 300 software application packages ported to it. 
The 68O3Obase0 NEWS 1850 is the mod recent addition 10 the tenet The NEWS t BOO 
Series is used in electrical and mechanical design automation asppltcaiions. particularly 
computer-aided design, mimifsctut ing and cngineerin g; and onqiputer-aided software 
engineering 

MoKpol a's $2.2 billion Semkxmd ucior Producis Sector (Pnoeru*. Ant-K which 
includes the Ma^ofBOcessor Pioduets Group (Austin, Texas), is a division of MoffwXa 
Inc. tt is the largest and broadest supplier of semiconductors In North Airssrica with a 
balanced portfolio of over 50 flOO devices. 
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For Sate: 6809 Microprocessor 80 megabyte hard drive: floppy disk drive; 
tape backup; 82 12 terminals; printer; umflcx opeiating system. Cshincrty and 
software available. SlS.SOO.00 Contact Cat Mueller. Bocllei Indusuics, Inc. 
Phone (507) 452-2315 

• •« 

MUSTANG-020 16Mhz with 68881. OS9 Professional Package & C $3000. 
Call Tom (615)842-460a 

AT&T 7300 UNIX PC. UNDC V OS. 1MB Memory, 20 MB Hard Disk. 5" 
Drive. Internal Modem, Mouse. Best Offer Gels It. 

S+Systcm with Cabinet, 20 Meg Haid Disk A 8" Disk Drive with DMAF3 
Controller Board 1-X12 Terminal S48O0. 

HARD »ISK 10 Megabyte Drive ■ Seagate Model #412 5275. 
3-Diial 8" drive enclosure with power supply. New in box. S125 each. 
S-Sianens 8" Disk Drive. $100 each. 

Tarto Outpost II, S6K, 2 5" DSDD Drives, FLEX, MUMPS. $495. 
QUME QVT.102 icnninal, like new, amber screen $250. or best offer. 

SWTPC SAM with Motorola I28K. RAM. I-MPS2. 1-PaiaUel Port, MP- 

09CPU Card- $900 complete. 

Tom <61S) 8424600 M-F9AM to 5PM EST 

• •• 

TWO SK-DOS Systems - (1) PT*9 6809 2-80T4 I40T ftoppies. Stylo, 
Dataman, Dynacalc, Basic, C. $400 - (2) PI~68K-l Indentical to newest 
Mustang 08/A. I2MHZ 68008 768K-80T Doppies &1 -25M hard disk. $1200. 
Also available with either system: QumeQVT- 108 terminal 14" amber $150. 
TI-8SS printer with 64K external buffer and extra font cailridges $350. 
Package Deal: PT-69, terminal and printer for $750. 
Marty Bose (41 S) 3S 1-7297 




Apple 

Macintosh- 

^ Users 



Save over a $1,000.00 

on PostScript 

Laser Printers! 

Faster - Finer Quality 

than the original Apple 

LaserWriter! 

New & Demos 

Cartridges-new-rebuilts 

-colors- 



is Chattanooga Call* 
«15 84 2-16*0 

QMS-Authorized 



Data-Co mp 



Conpiix haaaiina, he Sals 
tavn l< SHHBt iw aaan 
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NEW! 

OmegaSoft Pascal for the 68020/68881 



P20K it ■ Pual package Hi at *<ll ganaiata coda lor all of ttia 66000 
series prooauora. indudng the 68881 coproosssx P20K —» rm on any 
66000 series computer running the OS 9/66000 (Microwara) or POOS 
(Eying R match) operating systems »ith 5t2K or mora tree memory. 

The bast package (P20K-B) inch/dee tha Com pilar. Relocatable Micro 
Assembler. Unking Loader. Screen Edtor. Pascal Snail. Linkaga Craalor. 
Host Oebugger. Configuration managar, installailon program, and Patch 
uSity. A naw (aalura in thie com pilar ia tha aWity to either Knk in Iha parti 
of tha runtima naadad by tha program, or to use trap haixSere for rvntime 
access, to share tha runtime library between programs. Complete operating 
system interface ia also Included using pascal procedures and functions. 
The Host debugger allows debugging at both Iha Pascal and assembly 
language levels ol programa that run on the host opereting system Price 
for die base package ia (575. 



Tha runtime source coda option (P20K-R) ia avaBatte tor $100 and indude* 
source code lor the operating system interface rotrsnes as wall as pascal 
runtima. 

Tha UMcty anaea option (P20K-S) is avtilabla for S2 75 and mekrdes source 

coda for the Senear Editor. Pascal Shell. Host Debugger. Patch utility, and 
Configuration ma 



The Target debugger option (P20K-T) is S22S and includes object and 
source code. Thle program allows Pascal level and assembly level 
debugging in e aystam without operating system, by using s serial link 
connected to the host computer 

Prices do not include shipping charges. Master-Card and Visa accepted. 
OmegaSoft Is e registered trademark of Car bfiad Software Corporation 



Qespac SA. a Chemin das AU*. CH-122B. 
QerMvaJPIan-les-QuaMe. Switzerland 
TEL 022-713400. TLX 42M60 

Elsott AQ. Zalgwag t2. CJH-5405 Sedan- Oatt.il. 
Switzerland. TEL 0S6-B33377. TLX 62627$ 



PCS Microsystems Ltd . 141 Lhrbn dge Road. 
Hampton HH1, Mddaaex England. 
1EL Ot- 8782204. TLX 8851470 

Byte Studo Boot en. Bxtanwal 14. 4280 Boikeri. 

West Germany. 

TEL 02861 2V4 7. TLX 613343 



Ellec Elektroni*. GmbH. Galileo QaJilai-StraBe, 
6500 Mainz 42. Postfach 65. West Germany 
TEL 06131-50031. TLX 4167273 

PEP Elekbonk Systame GmbH. Am KJost erwald 4 
0.8050 Kaiift>Kns\ wast Germany 
TEL 06341-6974. TLX $41233 



CERTIFIED 
SOFTWARE 
CORROR AT 



616 C AMINO CABALLO. NIPOMO. CA 93444 USA 
TEL (805) 929-1395 TELEX 467013 
I O IVJ FAX (S05) 929-1395 (MID-8AM) 
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FLEXVSK-DOS VMS-DOS 



TM 



Transfer Utilities 

For 68XXX and CoCo* OS-9- Systems 

Now READ - WRITE - DIR - DUMP - EXPLORE 

FLEX, SK-DOS & MS-DOS Disk 

These Utilities come with a rich set of options allowing the 

transfer of text type files from/to FLEX & MS-DOS disks. 

CoCo systems require the D.P. Johnson SDISK utilities and OS-9 and two 
drives of which one must be a "host" floppy. 
CoCo Version: $69.95 68XXX Version $99.95 



S.E. Media 



615 842-6809 



PO Box 849, Hlxson.TN 37343 
MC/Vlsa 
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SUPERIOR SOFTWARE 

FOR YOUR 

6809 



SK-DOS* Disk 

Operating System $75.00 

Configuration Manual $50.00 

HUMBUG* Monitor $50.00 

MICflOBUG Monitor $30.00 

SPELL N FIX Spelling Checker $89.29 

STAR-DOS tor the Coco $34.50 

CHECK 'N TAX $50.00 



X 



AND 68000 



* sk«dos* 

Operating System $140.00 

* HUMBUG" Monitor $ 50.00 

* SPELL N FIX 

Spelling Checker (Coming) 




K 



SOFTWARESYSTCMSCORPORATION 

BOX 209 • MT. KISCO. NY 10549 -91*241 -0287 
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TIRED OF SLOW COMPUTERS ?? 

PROGRAMS SEEM TO TAKE FOREVER ?? 

DETROIT DATACOMM OFFERS A SOLUTION !! 

A hardware emulator executing 68000 object code !! 

Using a EOMhz clock with a floating point 
multiplier from Bipolar Integrated Technology 
Die system is capable ol up to 5 MIPS. 

- By running EXISTING software there is 
NO need to redo or convert programs 

- SWAP AND GO remove your existing CPU, 
plug in the hardware emulator and watch 
your program run in record time 

- Performs hardware square roots 
a real time SAVER !! 

Available July 1988 

Detroit Datacom Inc. 

1404 West 14 Mile Road 

Madison Heights, Ml. 48071 

1-(313)-524-2868 
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SOFTWARE FOR 680x AND MSDOS 



SUPER SLEUTH DISASSEMBLERS 

EACH SM-FLEX II0I.OS9 S100-UNIFLEX 

OSJECT-ONLT nilllMi EACH SM-FLEX.OSf.CDCO 
Htteractrvety generale source on dan wmh label*, mcrude .pel. binary rrdlwhg 
ipeciry 6S00.1.2.3.5.a.Sr6S02 voruon or ZBOrBOBOS varakKi 
OS) miiiw iso pracassai F1F1 tonui ocwa m under OSS 

COCO 008 available In MM.1.2. ,S«.»«50J vsrtlon (fwl Z&O/8080,S) on 
M010 dltltiemblar I100.FLEX,0S».UNIFLEX,l»S0OS.UHIX,Sir.0OS 

CROSS-ASSEMBLERS WITH MACRO CAPABILITIES 

EACH J50-FLEX.OS9.UNIFLEX.MSDOS.UNIX.SKDOS 3/JIO0 ALL/S200 
»MCII» 180«.eS02.«801/l1. 0004. 800S.S80S.Z8. ZOO. 8048.805 1 8085 .66010.32000 
/nodular cross easemblert el C wilh toad/unload ulUnle* 
lOlircM tor •drfrrrcnel ISO each, $100 tor \ »800 b> a» 



DEBUGGING SIMULATORS FOR POPULAR 8-BIT MICROPROCESSORS 
EACH S75-FLEX JI00-OS9 180-UNIFLEX 
ODJECT.ONIY Van lone: EACH 1M-COCO FLEX.COCO OSS 
IMerectrvery llmulele proceaioi*. BKIrde dltsMembry lormamng. Wuvy edgwig 
tpedt kx eeOO/1. (14)0805. 6S02. 8*09 OS1. 280 FLEX 

ASSEMBLER CODE TRANSLATORS FOR 6502. 6800/1. 6800 

aS02B!tXK i7i.Fl.EX MS-OSS MO-UNIFLEX 

8800/1 10 (SOg 8 6809 lo DOWIor) Hid <90-FLEX S79-05S JeO.UMIFlEX 

FULL-SCREEN XBASIC PROGRAMS with cursor conical 
AVAILABLE FOR FLEX. UNIFLEX, AND MSDOS 

DISPLAY GENERATOR/DOCUMENTOR *M areouree. >» wllllOut 

MAILING LtST SYSTEM 1100 wfaource, »IO •Uncut 

INVENTORY WITH «RP 1100 Woource, 130 arilhout 

TABULA RASA SPREADSHEET It 00 •'»»», J» wlmoul 

DISK AND XBASIC UTILITY PROGRAM LIBRARY 
150-FLEX S30-UNIFLEX/MSDOS 

edJl dim seclofi. eon elracjery. malnitn maaler catalog, do && tortlt 
f**ftqvenaa coma Of ol ol BASIC proormm. aref BASIC program, ale. 
norvf LEX vafUont rejude wl and reaeguencer opry 

CMODEM TELECOMMUNICATIONS PROGRAM 

|100-FLEX,OS9,UNIFLEX,MS-OOS,UNIX.SKDOS 
OSJECT-ONLY wakms: EACH t» 

menu-drtven wtn terminal mgM tire earnler. MOOEM7. XONXOFF. aK. 
tar COCO and non COCO: drive* anamal COCO modem pert up 10 2400 Baud 



DISKETTES & SERVICES 

5.25- DISKETTES 

EACH 10.PACK 17 50 SSSD SSDD DSDD 

American made, gvatanleed 10OK. qusbTr. with Tyvea (letter*, hub ring*, and labels 



ADDITIONAL SERVICES FOR THE COMPUTING COMMUNITY 
CUSTOMIZED PROGRAMMING 

we wet customize any ol the programs dfncfcoO mi lies edVervarrmenl Of In our 
orocflure tor specleibed iustomef use Of to gov** new proaruov*; ihe cttargo 
tor Such CutrOrnUellQn drrpanrla upon The me<v«t*t*r>r el the modiftcaUoni 

CONTRACT PROGRAMMING 

wa *• c/aala new progiama or medrly eilau^ proorems on a connect Deals, 
a aewtca we nave provided lor over twenty rears; irte oamcueu on which wo 
hiva perbrmed oor*rec t programming Include moat Popular modes ol 
mainframes, bKatdno IBM. Bufouoh*. Unhrae. Hrmerwes. most popular 
model* ol rrtlraDwnputora. Irctudvvj oec. IBM. 00. Ht>* AT&T, and mow 
popular brands 01 m awua i ea rwra , IndiOOO 6S00I1, WOO, 280. 6502. 
WOiO. using rnoti appropriate language* and operaong itrneml. on sytlem* 
fanoino al VH Irpcn large teien>rnmuntaaon» a) Irngle board eonlnVMra: 
rna cruue* tor conusct proorarnrnuio rs uaualy or Irte hour or by the teak 

CONSULTING 

we otter a wide ranoe ot PuaMesa and ledinlcal aKnuemg aorvlcei. trtduomg 

aarrunara, advice, trejnkng. and design, on any topic related 10 ODflVArlolS, 
Ihe cheiQ* tor consutuno is nomvSy basarj upon timo. vevel. and avperifaa 



Computer System* Consultant*, Inc. 

1454 Lalla Lano. Conyers. GA 30207 

Telephone 404-483-4570 or 1717 

We like order* si any lime, but pun 
long discussions after 6, II poaalble- 

Contaci us about catalog, dealer, discounts, and eervieea. 
Moal programs In source: give computer, OS. disk site. 
25% oil multiple purchases of same program on one order. 
VISA and MASTER CARD accepted; US lunda only, pleaae. 
Add GA sales tax {II In GA) and 5% shipping. 

(UNDFLEX tm Twdvwuu Syuana Coniuni-n osvs wcrewaia, 
COCO TaneybSOOS UcrrarOSUXlS Slut Somnn 
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K-BASIC- 

The Only 6809 BASIC to Binary Compiler for OS-9 

FLEX or SK*DOS 

Even runs on the 68XXX SK*DOS Systems* 



Hundreds Sold at 
Suggested Retail: 

$100.00 



• 6809 • 0S-9™ users can now transfer their R£X™ 
Extended BASIC (XBASIC) source tiles to OS-9, com- 
pile with the OS-9 version and run Ihem as any other 
OS-9 binary *CMD* program. Much faster than BASIC 
programs. 

• 6809 - FLEX users can compiler their BASIC source 
files to a regular FLEX ".CMD" file. Much faster execu- 
tion. 

• 68XXX - SK'DOS 1 " users running on 68XXX systems 
(such as the Mustang-08/A) can continue to execute 
their 6809 FLEX BASIC and compiled programs while 
getting things ported over to the 68XXX. SK'DOS 
alows 6809 programs to run in emulation mode. This is 
the only system we know of that will run both 6809 & 
68XXX binary files. 

K-BASIC is a true compiler. Comoiing BASIC 6809 pro- 
grams to binary command type programs. The savings 
in RAM needed and the increased speed of binary 
execution makes this a must for the serious user. And 
the price is now RIGHT. 

Don't get caught up In the "Learn a New Lan- 
guage" syndrome - Write Your Program In 
BASIC, Debug It In BASIC and Then Compile 
It to a .CMD Binary File. 



For a LIMITED time 

save over 65%... 

This sale will not be 

repeated after it's 

over! * 
.............. N 

SALE SPECIAL: 

$69.95 

v.. .......... .s 




Thank-You-Sale 



Onfy Jrom: 



c 



S.E. Media 



p 



i 



5900 Cassandra Smith Hd 

Mbiaort, Tn 37343 

Telephone 615 842-6809 

Telex 510 600-6630 



A Division of Computer Punishing Inc. 
Over 1,200 Titles • GBOD-tt&^XD 

* K HA.SK " wiS rwi imfcr 68XXX SX'DOS ii aaimkn mode far tie 6809 

Prix mtfA to <4*ve witna rukr 
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Clearbrook Software Group (604)853-9H8 



S%jJ ji\\ CSG IMS ,s THE full featured relatlon- 
g t C/* al database manager for OS9/OSK. 

^^} l># The comprehensive structured ap- 
■ BA aA| plication language and B + Tree Index 

IJ^M^t structures make CSG IMS the Ideal 
I tool for file-Intensive applications. 

CSG IMS for CoCo 2/3 OSS L1/2 (single user) $169.95 

CSG IMS for OS9 L2 Of 68000(multJ user) $495.00 

CSG IMS demo with manual $30 



SEH1NA - System Mode Debugger tor OSfl L2 

allows you to trace execution of any system module, 
set break points, assemble and disassemble code and 
examine and change memory. 

Requires CoCo3 or Glmlx tl, OS9 L2 & 80 col. terminal $139,00 



MSF - MSDos File Manager tor CoCo 3/OS9 Level 2 

allows you to use MSDos disks directly under OS9. 

Requires CoCo 3. OS9 12. SDISK3 driver $45.00 



EHINA - Symbolic User Mode Debugger for OS9 

lets you find bugs by displaying the machine state and 
instuctlons being executed. Set break points, change 
memory, assemble and disassemble code. 

Requires B0 column display, OS9 LI/2 $69.00 



Shipping: N. America - $5, Overseas - $10 
Clearbrook Software Group P.O. Box 6000-499, Sumas, WA 9B295 

OSS ll * IftdKntrk of MIcnmr* Sytitmi Corp . MSDot li a lrto«m«rt 0* Mlcttmrfl Corp. 



SPECIAL 

ATARI™ 

& 

OS-9™ 






NOW! 

If you have either the 

Atari 520 or 1040 - 

you can take 

advantage of the 

"bargain of a lifetime" 

OS-9 68K and BASIC 

all for the low, low price of: 



$150.00 

Call or Write 

S.E AAodia 

5900 Cassandra Smith Rd. 

Hixson. TN 37343 

615 842-4601 



ATARI & AMIGA 



CALL 



As most of you know, we are very sensitive to your 
wishes, as concerns the contents of these pages. One of 
the things that many of you have repeatedly written or 
called about is coverage forthe Atari & Amiga™ series of 
68000 computers. 

Actually we haven't been too keen on those systems 
due to a lack of serious software. They were mainly 
expensive "game-toy" systems. However, recently we are 
seeing more and more honest-to-goodness serious soft- 
ware for the Atari & Amiga machines. That makes a differ- 
ence. ] feel that we are ready to start some serious looking 
into a section for the Atari & Amiga computers. Especially 
so since OS-9 is now running on the Atari (review copy on 
the way for evaluation and report to you) and rumored for 
the Amiga. Many of you are doing all kinds of interesting 
things on these systems. By sharing we all benefit. 

This I must stress - Input from you on tbe Atari 
& Amiga. As most of you are aware, we are a 
"contributor supported" magazine. Thai means 
that YOU have to do your part. Which Is the way It 
has been for over 10 years. We need articles, tech- 
nical, reviews of hardware and software, pro- 
gramming (all languages) and the many other fac- 
ets of support that we have pursued for these many 
years. Also I will need several to volunteer to do 
regular columns on the Atari ft Amiga systems. 
Without constant input we can't make it ftyl So, if 
you do your part, we certainly will do ours. How 
about It, drop me a line or give me a phone call and 
I will get additional information right back to you. 
We need your input and support If this Is to succeed! 

DMW 
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THE 6800-6809 BOOKS 

..HEAR YE. NEAR 



OS-9" 
User Notes 



By: Peter Dibble 

The publlahera of 68' Micro Journal are proud to nake 
available the publication of Peter Dibbles 

QS9 usii ■ore 

Information for the BECDTMER to the PIO, 
tegular or CoCo OS9 

Dalai 059 

HELP, HINTS, PROBLEMS, REVIEWS, SUCCESTIONS , COMPLAINTS, 

0S9 STANDARDS, Generating a New Bootstrap, Building a 

new Syetea Wek, 0S9 Usera Croup, etc. 

Prograa interfacing Co 0S9 
DEVICE DESCRIPTORS, DIRECTORIES, "FORKS", PROTECTION, 
"SUSPEND STATE", "KIPES", "INPlfT/OUTPVT SYSTEM", etc. 

Prograaartog language a 

Asaeably Language Prograai and Interfacing; Baslc09, C, 
Paacal, and Cobol reviewa, programs, and uaea; etc. 



Make laclude 
•o tpelag all tba Source Llatlage la. Source Code and, 
where applicable, aaaeabled or compiled Operating 
Prograaa. The Source and the Dlacuasions In the 
Coluana can be uaed ~aa la", or aa a "Starting Point" 
for developing poer OWM aore powerful Prograaa. 
Prograaa aoaetiaea uae multiple Lsngusgea auch aa a 
ahort Aaaeably Language Routine for reading a 
Directory, which la then "piped" to a Baalc09 Routine 
for output formatting, etc. 



BOOK $9.95 

Typeaet -- w/ Source Listings 

(3-Hole Punched; S x II) 

Delate Usder SS.SU 



Ail Source Listings on Disk 

1-8" SS, SD 01 Ik SI*. 95 

2-i" SS, DO Make $24.95 




FLEX™ 
USER NOTES 

By: Ronald Anderson 

The publlahera of 68 MICRO JOURNAL are proud to 
Bake available the publication of Ron Anderaon'a FLEX 
DSIt NOTTS, In book fora. Thla popular aonthly coluwi 
l-een a regular feature in 68' MICRO JOURNAL SINCE 
1979. It haa earned the reaped of thousanda of 
68 MICRO JOURNAL readera over the yeara. In fact. 
a column haa been deacrlbed aa the 'Bible' for 68JCX 
uaera, by eone of the world'a leading mlcroproceaaor 
profe salonala. The aoat needed and popular 68XX book 
available. Over the yeara Ron'a coluan haa been one of 
the aoat popular In 68 MICRO JOURNAL. And of courae 
68 MICRO JOURNAL la the aoat popular 68XX aagatln* 
publlehed. 



Uated below are a few of the 
book end on dlakette. 



fUea Included In the 



Aa TEXT hies m Iha book are on trie Asks 



LOGO C» File load program to othei memory — ASM PIC 

MEMOVEC1 Memory move program — ASM PIC 

DUMPCl Pnnier dump prog/am — uses LOGO — ASM PIC 

SUBTEST C1 Simulation of 6800 code 10 6609. show UiUmnj B — ASM 

TEfiMEM C2 Modem input to disk {ot otter port atpul lo Cksk) — ASM 

M C2 Output a lile to modern lor another port) — ASM 

PRINT C3 Paraiei (enhanced) pnnter driver — ASM 

MODEM C2 TTL output to COT and modem (or otr-er port) — ASM 

SCIPKG C I Scientific math routines — PASCAL 

U C4 Mini-monitor, disk resident, many useful (unctions — ASM 

PRINT C4 Parallel printer drive), without PFLAG — ASM 

SETC5 Set printer modes— ASM 

SETBASI C5 Sel printer modes — A-BASIC 

NOTE: .CI..C2, etc. -Chapter I, Chapter 2, etc. 

'•Over 30 TEXT files included la ASM (eaaeabler >-PASCAL- 
PIC (poattlon independent code) TSC BASIC-C, etc. 

Book only: $7.95 + $2.50 S/H 
With disk: 5" $20.90 + $2.50 S/H 



With disk: 8' $22.90 + $2.50 S/H 

Shipping ft Handling $3.30 per Book. $2 SO pe» Dtsl set 

Ptwrign Orders Add S4.S0 Surface M«l 
or $7 00 Ail Mill 

tf paying by check - Pleise tUov 44 weeks dciivcry 

* AD Currency in U.S. OoILm 

Continually Updated In 68 Micro Journal Monthly 

Computer Publishing Inc. 

5900 Cassandra Smith Rd. 

Hixson, TN 37343 



'FLEX ta a trademark of Technical Syateaa Conaultanta 

"OS9 ia a trademark of MIcroware and Motorola 

"68' Micro Journal la a trademark of Coaputer Publlahlng Inc. 



(615) 842-4601 

Telex 5106006630 
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!!! Subscribe Now !!! 
68 MICRO JOURNAL 

OK, PLEASE ENTER MY SUBSCRIPTION 

Bill My: Mastercard |~1 VISAQ 



Card#. 



Exp. Dale_ 



For 1 Year 



2 Years 



3 Years 



Enclosed: $ 



Name 


Street 


City State 
Country 


Zip 


My Computer Is: 



Subscription Rates 



.^ 



^ 



U.S.A.: 1 Year $24.50, 2 Years $42.50, 3 Years $64.50 
•Foreign Surface: Add $12.00 per Year to USA Price. 
•Foreign Airmail: Add $48.00 per Year to USA Price. 

•Canada & Mexico: Add $9.50 per Year to USA Price. 

•U.S. Currency Cash or Check Drawn on a USA Bank ! 



68 Micro Journal 

5900 Cassandra Smith Rd 

POB 849 

Hixson.TN 37343 

Telephone 615 842-4600 
Telex 510 600-6630 





Reader Service Disks 

Disk. 1 FUtsort. Minicai, Mmicopy.M)ni/ms, "Lifetime. "Poetry 

"Foodlist. "Did. 

Diskedii w/instA fixes, Piime. •Pimod. "Snoopy. 

••Football, "HKpawrt."Lifelime. 

Cbug09. Seel, Sec2. Kind, Tablc2, Intexl, Disk-exp, 

•Disksave. 

Mailing Piogrun, 'Finddal, 'Change, 'Testdisk. 

•D1SKFK 1. 'DISKFIX 2, "LETTER. "LOVES1GN. 

"BI.ACKJAK. "BOWLING. 

"Purchase Order. Index (Disk rile indx). 

Linking Leader. Rload. Hardness. 

Cnest. (.anpno (May 82>. 

Datccopy. Diikfix9 (Aug 82). 

Home Accounting (July 82). 

Dissembler (June 84). 

Modcmo8 (Miy 84). 

*Ini(mf68, TestmfeS.'Cieamip.'Dikalign.Hdp.Daie.Txi 

•Init. "Test, •Terminal. 'Find. •Diskedii. bit-Lib. 

Modem9 + Updates (Dec. 84 Gilchiist) to Modem 

(April 84 Commo). 

Copy.Txl, Copy.Doc, CaLTxi, Cai.Doe. 

Match Utility, RATBAS. A Basic Preprocessor. 

PancMod. SizcCmrf (Sept. 85 Armstrong). CMDCODE. 

CMD.Txt (Sept 85 Spray). 

dock. Dale. Copy, Cat. PDELAsm St Dec. Errors. Sys, 

Do, Log. Asm A Doc 

UNIX Like Tools (July & Sept 85 Taylor & Gilchrist). 

Dragco.C. Giep.C. LS.C, FDUMP.C. 

Uuliues A Games • Dale. Life, Madness. Touch, Goblin. 

Starshot, St 15 more. 

Read CPM 4 Non-FLEX Disks, Frascr May 1984. 

ISAM, Indexed Sequential file Accessing Methods, 

Condon Nov. 1985. Extensible Table Driven. Language 

Recognition Utility, Andereon March 1986. 

68' Micro Journal Index of Aiticles St Bit Bucket liens 

from 1979- 1985, John Current 

KERMTT for FLEX derived from the UNIX ver. Burg 

Feb. 1986. (2>-5" Disks or (1)8" Disk. 

Compact* UniBoard icvicw. code St diagram, Burlison 

March -86. 

ROTABIT.TXT. SUMSTEST.TXT. CONDATA.TXT. 

B A DM EN. TXT. 

CT-82 Emulator, bit mapped 

"Star Trek 

Simple Winchester, Dec. '86 Green. 

"• Read/Wr te MS/PCDOS (SK'DOS) 

Heir-UNTX Type upgrade • 68MJ 2/87 

Build the GT-4 Terminal • 68MJ 1 1/87 Condon. 

FLEX 6809 Diagnostics. Disk Drive Test, ROM Test, 

RAM Test - 68MJ 4/88Korpi. 
NOTE: 
This is a reader service ONLY! No Warranty is of feted or implied, they are 
as received by 68* Micro Journal, and are for reader convenience ONLY 
(tome MAY include fixes or patches). Alio 6800 and 6809 programs are 
mixed, as each is fairly simple (mostly) to convert to the other. Software is 
available to cross-assemble all. 

• Denotes 6800 • •• Denotes BASIC 
• •• Denotes 68000 - 6809 no indicator. 



Dl.sk- 2 

Disk. 3 

Disk- 4 
Disk- 5 

Disk. 6 
Disk- 7 
Disk- 8 
Disk- 9 
Disk-10 
I Disk-ll 
Disk. 12 
Disk. 13 
Ulsk-14 
Disk- IS 

Disk- 16 
Disk- 17 
Diik-18 

Dlsk-II 

Disk 20 

Dlsk-21 

Disk-22 
Disk-23 



Disk. 24 

Disk-25 

Disk. 26 

01*. 27 

Dis*.28 
Dlsk-29 
Disk -30 
Disk-31 
Dlsk-32 
Dhtk-33 
Dlsk-34 




8" disk $19.50 
S" disk $16.95 



Mooter Cdfd 



J) 



Shipping & Handling -U.S.A. Add: - $3.50 
Overseas add: $4.30 Surface - $7.00 Airmail 

68 MICRO JOURNAL 

5900 Cassandra Smith Rd. 
Hixson, TN 37343 

(615)842-4600 - Telex 510 600-6630 
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PT-68000 SINGLE BOARD COMPUTER 

The PT68K2 is Available in a Variety ol Formats 
From Basic Kits to Completely Assembled Systems 



BASIC KIT (8 MHZ) • Board . 68000. 
HUMBUG MONITOR ♦ BASIC in ROM. 
4K STATIC RAM, 2 SERIAL PORTS, at 
Components $200 

PACKAGE DEAL - Complete Kit with 
Board 68000 10 MHZ, SK'DOS. 512K 
RAM. and all Necs&sary Paits $564 

ASSEMBLED BOARD (12 MHZ) 

Completely Tested, 1024K RAM. 
FLOPPY CONTROLLER, PIA. SrCOOS 
S899 

ASSEMBLED SYSTEM - 10 MHZ 
BOARD. CABINET POWER SUPPLY. 
MONITOR ♦ KEYBOARD. 80 TRACK 
FLOPPY DRIVE. CABLES $1299 
For A 20 MEG DRIVE, CONTROLLER 
and CABLES ' Add $345 



PROFESSIONAL OS9 



"SK'OOS it • Tiwjwnifti tt 

STAR.K SOFTWARE SYSTEMS CORP. 

"OSS k ■ Ti^enwh d Mtaowv* 



$500 




FEATURES 

MC68000 Processor. 8 MHZ Clock (optional 

10,12.5 MHZ) 

512K or 1024K ol DRAM (no wait states) 

4K of SPAM (61 16) 

32K.64K or 128K ol EPROM 

Four OS 232 Serial Ports 

Floppy disk controaer will control up to lour 

5 1/4", 40 or 80 track 

Clock with on-board battery. 

2 • 8 brt Parallel Ports 

Board can be mounted in an IBM type PC/ 

XT cabinet and has a power connector to 

match the IBM type power supply 

Expansion pons • 6 IBM PC/XT compatible 

I/O ports The HUMBUG- monitor supcots 

monochrome and/or color adaptor cards 

and Western Digital Winchester interlace 

cards 



PERIPHERAL TECHNOLOGY 



V 



1480 Terrell Mill Rd.. Suit* 870 

Marietta. Georgia 30067 

404/984-0742 

VISA/MASTERCARD/CHECK/C.O.D. 



Send For Catalogue 
For Complete Information On All Products 



J 
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DATA-COMP 



SPECIAL 



Heavy Duty Power Supplies 



For A frnBad ttna our HEAVY DUTY SWTTCHWG POWER SUPPLY. Thaw are BRAM) NEW unfa. 
prfc*8 era toss than 1/4 Ins normal pries tor thsas high qualify unfa. 




^ 



Notsthst 



Make: Boaterl 

Size: 103 x 5 x 23 inches 

Including horvy mcwbng hnrfc* and rratsink. 

Racmg: in 1KV220 vohs ac (strap change) Out 130 waits 

Output 



^\ 



+5v . 10 1 
+12v-4.0 amps 
+12v - 20 amps 
-12v ■ 03 amps 



Mating OmCD: Terminal strip 

Load Peaakav Auknutic short circuj recovery 

SPECIAL: $»55 each 

2 or more $4955 each 

Ad± $7 JO eadi S/H 



Make: fcnrhrrt 
Size ia75 x 62 x 225 inches 

Rating: 110/220 ac (strap change) Out 8] wnfls 

Outputs: +5v - 8.0 amps 
+12v . 24 amps 
+12v ■ 24 amps 
+12v-21 amps 
-12v . 0.4 amps 



Mating CORDOB Mokst 

Lead Readuv Aiaomanc short droit raxrvery 

SPECIAL: $4955 each 

2 or more $3955 each 

Ad± $7 JO S/H odi 



J K 



5900 Cassandra SmWi Rd, Hbtaon, Tn 37343 Tele p hone 615 642-4600 TCaSx 510 aDD-fita) 
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NOW THE GMX MICRO-20 HAS A TWIN - 
.d^^nnny She GMX TWINGLE-20 

68020 TWIN BOARD COMPUTER WITH MMU 




i annnnr minu ir 









All the features of the GMX Micro-20, PLUS - 

• 2 Megabytes additional RAM — for a total of 4 Megabytes of RAM 

• 8 more Serial ports — for a total of 12, and expandable up to 44. 

• MEMORY MANAGEMENT UNIT 



The GMX TWINGLE-20 consists ol 2 boards One of 
(he boards Is (he same as the Micro-20, except tor Ihe 68020 
processor which Is on the MMU board. It uses the same I/O 
expansion Interlace, serial adapter boards, and mounting holes as the 
GMX Micro-20. making It easy lo upgrade existing systems. Any of 
the currently available GMX Micro-20 I/O expansion boards can be 
used to provide additional I/O capability Expansion possibilities 
Include additional serial pals (up to 44 ports totat). additional parallel 
pons, and local area networking of up lo 255 GMX Micro -20s and/or 
TWINGLE-20S 

The MMU board contains the additional 2 Megabytes of 
RAM. 8 serial poits with 2 connectors tor Ihe SAB 4 port adaptor 
cards, and the MMU hardware. The MMU is a proprietary high-speed 
design that Hilly suppoits virtual memory The system RAM normally 
operates with only 1 wail-state, regardless ol processor speed An 
additional wait-state Is needed only when program Row crosses a 4K 
boundary. The MMU can be configured for any one of lour different 
maps, ranging from 8 tasks with 8 megabytes of virtual address 
space each, to 64 tasks ol 1 megabyte each. The MMU can be 
disabled lor applications that do not use hardware memory 
management. 

The TWINGLE-20 two board set can occupy the same 
Space as a fail-height 5.25' disk drive It is available In 12.5. 16 67 
or 20 MHz. versions, and with or without the 68881 FPC 

SPECIFICATIONS 

Size: 8.8 x 5.75 x 1.4 Inches. 

Power Requirements: -I- 5VDC ® 8 3A typical (20MHz. with 

68881). 

The TWINGLE-20 itself does nol require a + 12V supply. + 12V 

supply requirements, it any, are determined by Ihe serial adapter 

boards and any I/O expansion boards powered through the I/O 

Expansion Interlace 

GIT1X 1337 W. 37th Place. Chicago, IL 60609 
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SOFTWARE INCLUDED: 

An enhanced version ol 020Bug with diagnostics tor the MMU and 
the additional RAM and serial pons 

OPTIONAL SOFTWARE: 

UniFLEX VM, Virtual Memay version of the UniFLEX 
operating system which Includes all ol the teatures of the GMX 
Micro-20 version, plus lull MMU support 

The UniFLEX VM Operating System is a demand-paged, virtual 
memoiy operating system written In 68020 Assembler code tor 
compactness and efficiency. Any UniFLEX system will run taster 
than a comparable system written In a higher level language. This Is 
Impoilant in such areas as context switching, disk I/O, and system 
call handling Other teatures include: 
• Compact, efficient Kernel and modules allows handling more 

users more ellectively than UNIX systems, using much less disk 

space. 

UNIX system V compatibility at the C source code level. 

C Compiler optimized In 68020 code (optional). 

Record locking lor shared tiles. 

Users can share programs in memory. 

Modeled after UNIX systems, with similar commands. 

System accounting ladlities. 

Sequential and random life access 

Maximum record size limited only by the disk size. 

Multiple Level Directories. 

Up to 8 Megabytes of Virtual Memory per user. 
All the optional languages and software that run under UniFLEX lor 
the Micro-20 are also available for the TWINGLE-20. 

OS-9 Users can take advantage of the additional RAM and serial 
poils on the TWINGLE-20. It does not presently suppoit the MMU. 
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Now Offenng *FLEX" (2 Versions) 
AND 'STAR-DOS PLUS+ '" 




For Otttmrtng Call 

(615)842-4600 



FROM - DATA-COMP, C.P.I. 



A Family of 100% 68XX Support Facilities 

The Folks who FIRST Put FLEX" on 

The CoCo 
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STAR DOS PLUS + 

• Functions Same as FLEX 

• Reads • writes FLEX Disk* 

• Run FLEX Programs 

• Just type: Run 'STAR DOS" 

• Over 300 utilities & programs 
to choose from 



f 


TSC Editor 




NOW $35.00 


L 


y) 



PLUS 

ALL VERSIONS OF FLEX & STAR-DOS 

+ Read-Write-Dir RS Disk 
+ Run RS Basic from Both 
+ More Free UtJities 




INCLUDE 

+ External Terminal Program 
+ Test Disk Program 
+ Disk Examine & Repair Program 
+ Memoty Examine Program 
+ Many Many More!!! 



TSC Assembler 
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NOW $35 OO 
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CoCo Disk Drive Sgsleuis 



2 TH1NLINE DOUBLE SIDiO DOUBLE DENSITY DISK DRIVES 
SYSTEM WITN FDUEE SUCI-L* .CAIINtT, 01SI OllVE CARLE. JiH 
NEW DISK CONTROLLER JP0-CP VJTH J-OOS.RS-DOS OPERATINC 
SYSTEMS. |4*«.») 

• Spiel (y What CONTROLLER You Want JAN, or RADIO SHBCX 

TMINLINE DOUBLE S1DE0 
DOUBLE DENSITY *0 TRACKS 



MK VPCSAOi 

FOR C.0,E, P, AND COCO II 
RADIO SHACK BASIC I. 2 
EAD10 SHACK DISK BASIC 1.1 



Verhjhm Diskettes 



Sinftlf Sldad Doubl« DtDtity 
Deubl* Sided Double Deoelty 



Cooli oilers 



JtN JPO-CP WITH J-0OS 
WITH J-OOS, KS-OOS 
RADIO SHACK ] . I 

RADIO SHACK Diik CONTROLLER 1.1 



Disk Di ive Ciu!>-'> 



Ceble for One Drive 
Cable for Two Drive* 





DISK OltVE CABINET POl A 


III*. as 


SINGLE (WIVE 




DISK DRIVE CAEINET POl TWO 




TK1NLINE DRIVES 


} 14.00 


nirruj 


} 14.00 


EPSON U-BO 




EPSON HX-70 




EPSON KX-100 


•139. 95 


ACOMoaiE* rot ifboc 


$119. *» 




tiM.aj 


61*6 2E SEEIAL BOARD 


81*9 32K EXPAND TO I2BK 




EPSON MJ-M-UO KIIMNS 


413*. aj 


EPSON LX-80 ElEtONS 




TEACTOE UNITS PO« LX-BO 




CABLES 4 •THE* IHTCK/ACKS 




CALL POR PRICING 


i la.tj 




i 24. as 





I 29.95 



t 24. as 
i 24. as 



* 4».»5 

t ta.as 



B2M.9J 

•us.aj 
$»*i.*i 



JI49.95 

» s.as 



DATA-COMP 

5900 Cassandra Smith Rd 
Hixson. TN 37343 




C3| 


SHIPPING tS* 

f^:^ d ^" s .| (615)842-4600 

n(H. $2.50 'Of OtoWring 

Telex 5106006630 




s 



I I 

I An Ace of a System in Spades! The New j 

MUSTANG-08/A- 



I 
I 
I 
I 
I 
I 



Now with 4 aerial porta standard At apeed Increase to 12 Mhz CPU + on board battery 
backup and Includes the PROFESSIONAL OS-9 package - Including the $900.00 OS9 

C compiler! This offer wont last fcueveit 



NOT 128K, NOT 512K 



iFULL 768K No Wait RAM 



Now even faster! 
with 12 Mhz CPU 



I 



The MU5TANGOS TV system look svwy hand from al 
I other 68006 syserra we lasted ruming OS-9 68K1 
I The MU5TANTXB Mudes OSS«K™ Srttor Plater 
| Stark's SrCDOS™ . SKDOS is a single user, single tasMng 
| system that takes up where *R£X~ left off. SKTDQS is 
| actuary a 86XXX FLEX type system (Not a TSC pKXkd.) 
OS-9 "Si i> mi»Vi j^^-i^i bkwrtnnHBfiiBwun* 



C Compile ttmec OS-9 68K Eiaid Disk"^ 
MJ5TANG0B 8 Mb CPU 0n*l-32SK 

Other pooubr 69008 syiern Insn -OS ate 

MUSTANMM 0mfn-2lsse 



Jt 




j System tndudea OS-9 68K or SCDOS - Yow Choice 



Spariflcalions: 



CPU 

RAM 

PORTS 

CLOCK 
EPR0M 
R.0PPY 
HARD DISK 



MC680OB 

7Gax 
NoVW: 
4-RS232 
2-8br.Parato) 
MK48T02 
16K,3*or&*X 
WD1 772 
fcWtee Port 



12 Mhz 
2SEK ChijB 

UC8BB1 QUART 
MC6S1 PIA 

Real Tins Oh* Bat B/U 
Sflfcrisbe 
5 1M0riwB 
WD1QCB Bod 



25 Megabyte 
Hard Disk System 



i 
i 

i 
i 
i 
i 
i 
i 
i 

Y Now more serial ports - faster CPU i 
| Battery b/U - and $850.00 OS 9 Profes | 
* slonal with C compiler included! 



*$400.00 



See Mustangs Ad • page 5 

for trade-in delate 



J 




MUSTANG-08 



LOOK 



Somds 



OS-9 E8K 
00-9 6SK. 



32 b* Reiner 

...18.0... 9.5 
.9.8. ..6.3 



r bit I; V 

register long I; 

for (bO; I < 009999; ♦*!); 



$2,398.90 

Complete with PROFESSIONAL OS-9 

includes the $500.00 C compiler, PC 

style cabinet, heavy duty power supply, 

5 DDDS 60 track floppy. 25 MegByte 

t^ Hard Disk - Ready to Run j 

UhSta other 68006 systems there are several srjnBbanl 
dWararcBB. The MUSTANG-08 is a full 12 Megahertz sydem. The 
RAM U58B NO wal aisles, this means M bora MUSTANG type 
performance. 

Abo, aibwrg for addressable RDtvVPROM the RAM is the 
maximum eJowed for a 68008. The 68008 can only address a 
total of 1 Megabytes of RAM. The dasrgn atbws al tha RAM 
apace (for al practical purposes) to be utlfead What Is not 
avalabte to the user is reqused and reserved for tha system. 

A RAM da* of 480K can be eesly conjured, leaving 288K 
free for proprB/rvSyaarri RAM space. The RAM DISK can be 
cDnfgured to any aba your appfcatfon requres (system must 
have 128K In addibbn to ts other requirements) Lsavrg tha 
remainder of the ongral 768K for program use. ScJTubti 
source included (driver* etc) 



MUSTANGS* (■ 



f 



Data-Comp Division 

A Decade of Quality Service" 




7 ^^BM^ Systems World -Wkie 

Computer Publishing, Inc. 5900 Cassarcra SftHh Road 
Tabphone 615842-4601 - Telex 510 600-6630 rfxsorx Tn 37343 

* Those wtti SW1PC hf-dantffy FLEX S' • CoJ for special hto. 



